Team-Commonly
diff --git a/‎.env.example‎
Lines changed: 18 additions & 3 deletions b/‎.env.example‎
Lines changed: 18 additions & 3 deletions
diff --git a/‎cli/__tests__/dev.test.mjs‎
Lines changed: 148 additions & 0 deletions b/‎cli/__tests__/dev.test.mjs‎
Lines changed: 148 additions & 0 deletions
@@ -66,28 +66,40 @@ ANTHROPIC_API_KEY=
 
 # OpenAI / Codex
 OPENAI_API_KEY=
+OPENAI_BASE_URL=
 
 # OpenRouter (multi-model fallback)
 OPENROUTER_API_KEY=
+OPENROUTER_BASE_URL=
 
 # Google Gemini (direct, not via OpenRouter)
 GEMINI_API_KEY=
 
-# LiteLLM proxy (if self-hosting a LiteLLM gateway)
+# LiteLLM proxy
+# LITELLM_API_KEY = virtual key for the shared dev LiteLLM or another proxy
+# LITELLM_MASTER_KEY = operator-only admin key for self-hosting/admin tasks
+LITELLM_API_KEY=
 LITELLM_BASE_URL=
 LITELLM_MASTER_KEY=
 
 # -----------------------------------------------------------------------------
 # Agent runtime  (OPTIONAL — only needed if running the OpenClaw/Clawdbot gateway)
 # -----------------------------------------------------------------------------
+# Phase 2 target gate for local clawdbot parity. Keep off unless you are
+# actively working on the local OpenClaw runtime path.
+COMMONLY_LOCAL_CLAWDBOT=0
+
 CLAWDBOT_GATEWAY_TOKEN=    # token for the gateway's Commonly account
 
 # Brave Search (used by agents that do web searches)
 # Get a free API key at https://api.search.brave.com/
 BRAVE_API_KEY=
+TAVILY_API_KEY=
+FIRECRAWL_API_KEY=
+DEEPGRAM_API_KEY=
 
-# GitHub PAT (used by dev agents to create PRs)
-# Required scopes: repo Contents R/W, Pull requests R/W
+# GitHub PAT (used by dev agents to clone/fetch/push/create PRs)
+# Required scopes: Contents R/W, Pull requests R/W, Metadata R
 GITHUB_PAT=
 
 # -----------------------------------------------------------------------------
@@ -97,6 +109,9 @@ DISCORD_CLIENT_ID=
 DISCORD_BOT_TOKEN=
 DISCORD_PUBLIC_KEY=
 DISCORD_CLIENT_SECRET=
+SLACK_APP_TOKEN=
+SLACK_BOT_TOKEN=
+TELEGRAM_BOT_TOKEN=
 
 # -----------------------------------------------------------------------------
 # Email  (OPTIONAL — accounts auto-verify without it in development)
 
@@ -0,0 +1,148 @@
+import fs from 'fs';
+import os from 'os';
+import path from 'path';
+import { jest } from '@jest/globals';
+
+import {
+  upsertEnvFileValues,
+  patchClawdbotConfig,
+  bootstrapClawdbotRuntime,
+} from '../src/commands/dev.js';
+
+describe('dev command helpers', () => {
+  test('upsertEnvFileValues updates existing keys and appends missing ones', () => {
+    const current = [
+      '# local dev',
+      'COMMONLY_LOCAL_CLAWDBOT=0',
+      'JWT_SECRET=test-secret',
+      '',
+    ].join('\n');
+
+    const next = upsertEnvFileValues(current, {
+      COMMONLY_LOCAL_CLAWDBOT: '1',
+      OPENCLAW_RUNTIME_TOKEN: 'cm_agent_test',
+    });
+
+    expect(next).toContain('COMMONLY_LOCAL_CLAWDBOT=1');
+    expect(next).toContain('JWT_SECRET=test-secret');
+    expect(next).toContain('OPENCLAW_RUNTIME_TOKEN=cm_agent_test');
+    expect(next.startsWith('# local dev')).toBe(true);
+    expect(next.endsWith('\n')).toBe(true);
+  });
+
+  test('patchClawdbotConfig syncs gateway, account, and binding state', () => {
+    const patched = patchClawdbotConfig({
+      config: {
+        channels: {
+          commonly: {
+            enabled: true,
+            baseUrl: 'http://backend:5000',
+            accounts: {},
+          },
+        },
+        agents: { list: [] },
+        bindings: [],
+      },
+      accountId: 'local',
+      podId: 'pod-1',
+      displayName: 'Local OpenClaw',
+      runtimeToken: 'cm_agent_test',
+      userToken: 'cm_user_test',
+      gatewayToken: 'gateway-test',
+    });
+
+    expect(patched.gateway.auth.token).toBe('gateway-test');
+    expect(patched.gateway.controlUi.dangerouslyAllowHostHeaderOriginFallback).toBe(true);
+    expect(patched.channels.commonly.accounts.local.runtimeToken).toBe('cm_agent_test');
+    expect(patched.channels.commonly.accounts.local.userToken).toBe('cm_user_test');
+    expect(patched.channels.commonly.accounts.local.podIds).toEqual(['pod-1']);
+    expect(patched.bindings).toContainEqual({
+      agentId: 'local',
+      match: { channel: 'commonly', accountId: 'local' },
+    });
+    expect(patched.agents.list).toContainEqual(expect.objectContaining({
+      id: 'local',
+      name: 'Local OpenClaw',
+    }));
+  });
+
+  test('bootstrapClawdbotRuntime writes env and config using the runtime-token routes', async () => {
+    const repoRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'commonly-dev-test-'));
+    const envExamplePath = path.join(repoRoot, '.env.example');
+    const envPath = path.join(repoRoot, '.env');
+    const configPath = path.join(repoRoot, 'external', 'clawdbot-state', 'config', 'moltbot.json');
+
+    fs.writeFileSync(envExamplePath, 'COMMONLY_LOCAL_CLAWDBOT=0\nCLAWDBOT_GATEWAY_TOKEN=\n', 'utf8');
+    fs.mkdirSync(path.dirname(configPath), { recursive: true });
+    fs.writeFileSync(configPath, `${JSON.stringify({
+      channels: {
+        commonly: {
+          enabled: true,
+          baseUrl: 'http://backend:5000',
+          accounts: {},
+        },
+      },
+      agents: { list: [] },
+      bindings: [],
+    }, null, 2)}\n`, 'utf8');
+
+    const client = {
+      get: jest.fn(async (route) => {
+        if (route === '/api/pods') return [];
+        if (route === '/api/registry/pods/pod-1/agents') return { agents: [] };
+        throw new Error(`unexpected GET ${route}`);
+      }),
+      post: jest.fn(async (route, body) => {
+        if (route === '/api/pods') {
+          return { _id: 'pod-1', name: body.name };
+        }
+        if (route === '/api/registry/install') {
+          return {
+            installation: {
+              agentName: 'openclaw',
+              instanceId: 'local',
+              podId: body.podId,
+              displayName: body.displayName,
+            },
+          };
+        }
+        if (route === '/api/registry/pods/pod-1/agents/openclaw/provision') {
+          return { configPath: '/app/external/clawdbot-state/config/moltbot.json' };
+        }
+        if (route === '/api/registry/pods/pod-1/agents/openclaw/runtime-tokens') {
+          expect(body).toEqual({ instanceId: 'local', force: true });
+          return { token: 'cm_agent_fresh' };
+        }
+        if (route === '/api/registry/pods/pod-1/agents/openclaw/user-token') {
+          return { token: 'cm_user_fresh' };
+        }
+        throw new Error(`unexpected POST ${route}`);
+      }),
+    };
+
+    const result = await bootstrapClawdbotRuntime({
+      client,
+      repoRoot,
+      instanceId: 'local',
+      displayName: 'Local OpenClaw',
+      gatewayToken: 'gateway-fresh',
+    });
+
+    expect(result.podId).toBe('pod-1');
+    expect(result.podCreated).toBe(true);
+    expect(result.installationCreated).toBe(true);
+    expect(result.runtimeToken).toBe('cm_agent_fresh');
+    expect(result.userToken).toBe('cm_user_fresh');
+
+    const envContents = fs.readFileSync(envPath, 'utf8');
+    expect(envContents).toContain('COMMONLY_LOCAL_CLAWDBOT=1');
+    expect(envContents).toContain('CLAWDBOT_GATEWAY_TOKEN=gateway-fresh');
+    expect(envContents).toContain('OPENCLAW_RUNTIME_TOKEN=cm_agent_fresh');
+    expect(envContents).toContain('OPENCLAW_USER_TOKEN=cm_user_fresh');
+
+    const parsedConfig = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+    expect(parsedConfig.gateway.controlUi.dangerouslyAllowHostHeaderOriginFallback).toBe(true);
+    expect(parsedConfig.channels.commonly.accounts.local.runtimeToken).toBe('cm_agent_fresh');
+    expect(parsedConfig.channels.commonly.accounts.local.userToken).toBe('cm_user_fresh');
+  });
+});