@myclaw163/clawclaw-cli 0.6.69 → 0.6.71

package/bin/clawclaw-cli.mjs

@@ -1,4 +1,4 @@
 #!/usr/bin/env node
-import { register } from 'tsx/esm/api';
-register();
-await import('../src/cli.ts');
+import { register } from 'tsx/esm/api';
+register();
+await import('../src/cli.ts');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@myclaw163/clawclaw-cli",
-  "version": "0.6.69",
+  "version": "0.6.71",
   "type": "module",
   "description": "ClawClaw social deduction game CLI",
   "bin": {

package/scripts/sync-bundled-skill.mjs

@@ -1,4 +1,4 @@
-import { spawnSync } from 'child_process';
+import { spawnSync } from 'child_process';
 import { createHash } from 'crypto';
 import {
   cpSync,

package/skills/clawclaw/references/STRATEGIES.md

@@ -8,10 +8,12 @@
 ccl strategy --list
 ```
 
-`--list` 返回当前实际加载到的策略 `id` 和 `description`，包括内置策略、Hub 策略和本地自定义策略；如果用户用同名策略覆盖官方策略，也以这里显示的结果为准。
+`--list` 返回当前实际加载到的策略 `id`、`name` 和 `description`，包括内置策略、Hub 策略和本地自定义策略；如果用户用同名策略覆盖官方策略，也以这里显示的结果为准。
 
 `description` 是策略选择的第一入口。它应说明策略做什么、是否需要参数、参数怎么传，以及是否读取 `ccl knowledge`。
 
+`name` 是策略的中文代词（如「守尸」「武士虾」），是玩家和你口头沟通时用的称呼。玩家说「切到守尸」时，你据此映射回对应 `id`。`id` 仍是规范选择器，但 `ccl strategy <name>`（中文名）与 `ccl strategy <id>` 等价，两者都能启动。
+
 ## 策略选择流程
 
 1. 先确认当前策略：从 `ccl game start` 短通知、`ccl events` 返回的 state / 事件，或最近一次 `ccl strategy <id>` 的启动结果里，看现在正在跑什么策略。
@@ -25,7 +27,7 @@ ccl strategy --info <id>
 ```
 
 6. 如需让当前策略对特定玩家或事实做出反应，使用 `ccl knowledge` 写入判断；如果是整体目标变化，则切换策略。
-7. 启动策略：
+7. 启动策略（`<id>` 处也可填中文 `name`）：
 
 ```bash
 ccl strategy <id> [args...]
@@ -54,4 +56,4 @@ ccl strategy --info <id>
 
 ## 能力边界说明
 
-> **策略是有限集合——不要暗示它们无所不能。** `ccl strategy --list` 是当前实际可用策略目录。**当用户要求的玩法超出这些策略能力时，直说——告诉用户当前策略不支持。** 不要拖延、不要假装某个策略能做到、不要沉默忽略请求。然后提供最接近的方案：让现有策略覆盖能做的部分，其余用 `ccl do`（发言/投票/思考）、手动 `ccl strategy` 切换或手动移动来处理——明确指出哪些是策略自动化的、哪些是你手动操作的、哪些确实无法实现。当差距真实存在——请求需要当前策略都不支持的自动化行为时——主动引导用户到 clawclawhub：`ccl hub search` 浏览社区策略，`ccl hub install <type>/<id>` 安装用户选中的。安装后用 `ccl strategy --list` 确认策略可用。如果那里也不适合，建议创建自定义策略：在 `<workspace>/strategies/` 下放 `.ts` / `.js` 文件，导出 `strategy`（id / description / create），从 `clawclaw-cli` 导入辅助函数。主动提出为他们编写——API 和示例见 `ccl strategy -h` 和 `docs/自定义策略.md`。
+> **策略是有限集合——不要暗示它们无所不能。** `ccl strategy --list` 是当前实际可用策略目录。**当用户要求的玩法超出这些策略能力时，直说——告诉用户当前策略不支持。** 不要拖延、不要假装某个策略能做到、不要沉默忽略请求。然后提供最接近的方案：让现有策略覆盖能做的部分，其余用 `ccl do`（发言/投票/思考）、手动 `ccl strategy` 切换或手动移动来处理——明确指出哪些是策略自动化的、哪些是你手动操作的、哪些确实无法实现。当差距真实存在——请求需要当前策略都不支持的自动化行为时——主动引导用户到 clawclawhub：`ccl hub search` 浏览社区策略，`ccl hub install <type>/<id>` 安装用户选中的。安装后用 `ccl strategy --list` 确认策略可用。如果那里也不适合，建议创建自定义策略：在 `<workspace>/strategies/` 下放 `.ts` / `.js` 文件，导出 `strategy`（id / name / description / create），从 `clawclaw-cli` 导入辅助函数。主动提出为他们编写——API 和示例见 `ccl strategy -h` 和 `docs/自定义策略.md`。

package/src/commands/config.ts

@@ -1,30 +1,30 @@
-import { Command } from 'commander';
-import { getWorkspaceDir } from '../lib/init-command.js';
-import { AuthStore } from '../lib/auth.js';
-
-export function createWorkspaceSubcommand(): Command {
-  return new Command('workspace')
-    .description('Print the workspace directory path')
-    .action(() => {
-      console.log(getWorkspaceDir());
-    });
-}
-
-export function createApikeySubcommand(): Command {
-  return new Command('apikey')
-    .description('Print the active account API key')
-    .action(() => {
-      const store = new AuthStore();
-      const profile = store.getActive();
-      if (!profile) throw new Error('Not logged in. Run: clawclaw-cli account register');
-      console.log(profile.apiKey);
-    });
-}
-
-export function createConfigCommand(): Command {
-  const config = new Command('config');
-  config.description('Query ClawClaw CLI configuration.');
-  config.addCommand(createWorkspaceSubcommand());
-  config.addCommand(createApikeySubcommand());
-  return config;
-}
+import { Command } from 'commander';
+import { getWorkspaceDir } from '../lib/init-command.js';
+import { AuthStore } from '../lib/auth.js';
+
+export function createWorkspaceSubcommand(): Command {
+  return new Command('workspace')
+    .description('Print the workspace directory path')
+    .action(() => {
+      console.log(getWorkspaceDir());
+    });
+}
+
+export function createApikeySubcommand(): Command {
+  return new Command('apikey')
+    .description('Print the active account API key')
+    .action(() => {
+      const store = new AuthStore();
+      const profile = store.getActive();
+      if (!profile) throw new Error('Not logged in. Run: clawclaw-cli account register');
+      console.log(profile.apiKey);
+    });
+}
+
+export function createConfigCommand(): Command {
+  const config = new Command('config');
+  config.description('Query ClawClaw CLI configuration.');
+  config.addCommand(createWorkspaceSubcommand());
+  config.addCommand(createApikeySubcommand());
+  return config;
+}

package/src/commands/game.ts

@@ -364,7 +364,7 @@ function autoStartStrategy(roleData: any, stateData?: any, gameId?: string): { s
   return { strategy: strategyId, pid: child.pid, child };
 }
 
-async function runGameStart(opts: { watch: boolean; force?: boolean }): Promise<void> {
+async function runGameStart(opts: { watch: boolean; force?: boolean; channelUrl?: string }): Promise<void> {
   if (process.env.CLAWCLAW_REQUIRE_STREAM_TOOL === '1' && process.env.CLAWCLAW_STREAMED !== '1') {
     process.stderr.write(
       'In OpenClaw, start the game via the clawclaw_game_start tool - do not exec `ccl game start` directly.\n' +
@@ -434,7 +434,11 @@ async function runGameStart(opts: { watch: boolean; force?: boolean }): Promise<
   process.on('SIGINT', onOwnerSignal);
   process.on('SIGTERM', onOwnerSignal);
   const emit = (obj: Record<string, any>): void => {
-    process.stdout.write(JSON.stringify(obj) + '\n');
+    const line = JSON.stringify(obj) + '\n';
+    process.stdout.write(line);
+    if (opts.channelUrl) {
+      fetch(opts.channelUrl, { method: 'POST', body: line }).catch(() => {});
+    }
   };
   const emitLifecycle = (
     reason: string,
@@ -500,7 +504,7 @@ async function runGameStart(opts: { watch: boolean; force?: boolean }): Promise<
         feedPath,
         sessionPath,
         getSessionPath: () => EventStore.latestSessionPath(),
-        stdout: (s) => process.stdout.write(s),
+        stdout: (s) => { process.stdout.write(s); if (opts.channelUrl) { fetch(opts.channelUrl, { method: 'POST', body: s }).catch(() => {}); } },
         signal: ctrl.signal,
         skipFeedWait: true,
         readSummary: currentSummary,
@@ -819,6 +823,7 @@ export function createGameCommand(): Command {
     .description('Start or resume the owner game runtime, then stream events as NDJSON until game_over. Pass --no-watch to exit after allocation. Pass --force to replace an orphaned game-start runtime.')
     .option('--no-watch', 'exit after allocation instead of streaming events through game_over')
     .option('--force', 'force restart: kill any lingering game-start stream process and start fresh')
+    .option('--channel-url <url>', 'forward each NDJSON line via HTTP POST to this URL')
     .action(runGameStart);
 
   game

package/src/commands/setup/hermes.test.ts

@@ -1,96 +1,96 @@
-import { describe, expect, it, vi, beforeEach } from 'vitest';
-import { runHermesSetup } from './hermes.js';
-import { spawnSync } from 'child_process';
-
-vi.mock('child_process', () => ({
-  spawnSync: vi.fn(),
-}));
-
-const mockedSpawnSync = vi.mocked(spawnSync);
-
-function mockSpawn(overrides: Array<{ status: number; stdout?: string; stderr?: string }>) {
-  mockedSpawnSync.mockImplementation((_cmd: any, _args?: any, _opts?: any): any => {
-    const next = overrides.shift();
-    if (!next) throw new Error('Unexpected spawnSync call');
-    return {
-      status: next.status,
-      stdout: next.stdout ?? '',
-      stderr: next.stderr ?? '',
-    };
-  });
-}
-
-beforeEach(() => {
-  vi.clearAllMocks();
-});
-
-describe('runHermesSetup', () => {
-  it('returns error when hermes CLI is not found', () => {
-    mockSpawn([{ status: 1, stderr: 'command not found' }]);
-    const r = runHermesSetup({});
-    expect(r.exitCode).toBe(1);
-    expect(r.output.some((l) => l.includes('not found'))).toBe(true);
-  });
-
-  it('reports already-enabled when clawclaw is in plugins list', () => {
-    mockSpawn([
-      { status: 0 },                                  // --version
-      { status: 0, stdout: 'clawclaw\nother-plugin' }, // plugins list
-    ]);
-    const r = runHermesSetup({});
-    expect(r.exitCode).toBe(0);
-    expect(r.output.some((l) => l.includes('already enabled'))).toBe(true);
-  });
-
-  it('dry-run shows pending message when not enabled', () => {
-    mockSpawn([
-      { status: 0 },                                  // --version
-      { status: 0, stdout: 'other-plugin' },           // plugins list
-    ]);
-    const r = runHermesSetup({});
-    expect(r.exitCode).toBe(2);
-    expect(r.output.some((l) => l.includes('Dry-run'))).toBe(true);
-  });
-
-  it('--print shows the command that would run', () => {
-    mockSpawn([
-      { status: 0 },                                  // --version
-      { status: 0, stdout: 'other-plugin' },           // plugins list
-    ]);
-    const r = runHermesSetup({ print: true });
-    expect(r.exitCode).toBe(0);
-    expect(r.output.some((l) => l.includes('hermes plugins enable clawclaw'))).toBe(true);
-  });
-
-  it('-y runs hermes plugins enable and succeeds', () => {
-    mockSpawn([
-      { status: 0 },                                  // --version
-      { status: 0, stdout: 'other-plugin' },           // plugins list
-      { status: 0, stdout: 'plugin enabled' },         // plugins enable
-    ]);
-    const r = runHermesSetup({ yes: true });
-    expect(r.exitCode).toBe(0);
-    expect(r.output.some((l) => l.includes('enabled'))).toBe(true);
-  });
-
-  it('-y handles hermes plugins enable failure', () => {
-    mockSpawn([
-      { status: 0 },                                  // --version
-      { status: 0, stdout: 'other-plugin' },           // plugins list
-      { status: 1, stderr: 'permission denied' },      // plugins enable
-    ]);
-    const r = runHermesSetup({ yes: true });
-    expect(r.exitCode).toBe(1);
-    expect(r.output.some((l) => l.includes('Failed'))).toBe(true);
-  });
-
-  it('already-enabled short-circuits --print', () => {
-    mockSpawn([
-      { status: 0 },                                  // --version
-      { status: 0, stdout: 'clawclaw' },               // plugins list
-    ]);
-    const r = runHermesSetup({ print: true });
-    expect(r.exitCode).toBe(0);
-    expect(r.output.some((l) => l.includes('already enabled'))).toBe(true);
-  });
-});
+import { describe, expect, it, vi, beforeEach } from 'vitest';
+import { runHermesSetup } from './hermes.js';
+import { spawnSync } from 'child_process';
+
+vi.mock('child_process', () => ({
+  spawnSync: vi.fn(),
+}));
+
+const mockedSpawnSync = vi.mocked(spawnSync);
+
+function mockSpawn(overrides: Array<{ status: number; stdout?: string; stderr?: string }>) {
+  mockedSpawnSync.mockImplementation((_cmd: any, _args?: any, _opts?: any): any => {
+    const next = overrides.shift();
+    if (!next) throw new Error('Unexpected spawnSync call');
+    return {
+      status: next.status,
+      stdout: next.stdout ?? '',
+      stderr: next.stderr ?? '',
+    };
+  });
+}
+
+beforeEach(() => {
+  vi.clearAllMocks();
+});
+
+describe('runHermesSetup', () => {
+  it('returns error when hermes CLI is not found', () => {
+    mockSpawn([{ status: 1, stderr: 'command not found' }]);
+    const r = runHermesSetup({});
+    expect(r.exitCode).toBe(1);
+    expect(r.output.some((l) => l.includes('not found'))).toBe(true);
+  });
+
+  it('reports already-enabled when clawclaw is in plugins list', () => {
+    mockSpawn([
+      { status: 0 },                                  // --version
+      { status: 0, stdout: 'clawclaw\nother-plugin' }, // plugins list
+    ]);
+    const r = runHermesSetup({});
+    expect(r.exitCode).toBe(0);
+    expect(r.output.some((l) => l.includes('already enabled'))).toBe(true);
+  });
+
+  it('dry-run shows pending message when not enabled', () => {
+    mockSpawn([
+      { status: 0 },                                  // --version
+      { status: 0, stdout: 'other-plugin' },           // plugins list
+    ]);
+    const r = runHermesSetup({});
+    expect(r.exitCode).toBe(2);
+    expect(r.output.some((l) => l.includes('Dry-run'))).toBe(true);
+  });
+
+  it('--print shows the command that would run', () => {
+    mockSpawn([
+      { status: 0 },                                  // --version
+      { status: 0, stdout: 'other-plugin' },           // plugins list
+    ]);
+    const r = runHermesSetup({ print: true });
+    expect(r.exitCode).toBe(0);
+    expect(r.output.some((l) => l.includes('hermes plugins enable clawclaw'))).toBe(true);
+  });
+
+  it('-y runs hermes plugins enable and succeeds', () => {
+    mockSpawn([
+      { status: 0 },                                  // --version
+      { status: 0, stdout: 'other-plugin' },           // plugins list
+      { status: 0, stdout: 'plugin enabled' },         // plugins enable
+    ]);
+    const r = runHermesSetup({ yes: true });
+    expect(r.exitCode).toBe(0);
+    expect(r.output.some((l) => l.includes('enabled'))).toBe(true);
+  });
+
+  it('-y handles hermes plugins enable failure', () => {
+    mockSpawn([
+      { status: 0 },                                  // --version
+      { status: 0, stdout: 'other-plugin' },           // plugins list
+      { status: 1, stderr: 'permission denied' },      // plugins enable
+    ]);
+    const r = runHermesSetup({ yes: true });
+    expect(r.exitCode).toBe(1);
+    expect(r.output.some((l) => l.includes('Failed'))).toBe(true);
+  });
+
+  it('already-enabled short-circuits --print', () => {
+    mockSpawn([
+      { status: 0 },                                  // --version
+      { status: 0, stdout: 'clawclaw' },               // plugins list
+    ]);
+    const r = runHermesSetup({ print: true });
+    expect(r.exitCode).toBe(0);
+    expect(r.output.some((l) => l.includes('already enabled'))).toBe(true);
+  });
+});

package/src/commands/setup/hermes.ts

@@ -1,76 +1,76 @@
-/**
- * `ccl setup hermes` — enable the clawclaw plugin in Hermes via `hermes plugins enable`.
- */
-
-import { Command } from 'commander';
-import { spawnSync } from 'child_process';
-
-export const PLUGIN_ID = 'clawclaw';
-
-export interface SetupHermesResult {
-  exitCode: number;
-  output: string[];
-}
-
-export function runHermesSetup(flags: { yes?: boolean; print?: boolean }): SetupHermesResult {
-  const out: string[] = [];
-
-  // Check hermes is available
-  const which = spawnSync('hermes', ['--version'], { stdio: 'pipe', timeout: 5000 });
-  if (which.status !== 0) {
-    out.push('hermes CLI not found. Install it first, then re-run.');
-    return { exitCode: 1, output: out };
-  }
-
-  // Check current plugin status
-  const list = spawnSync('hermes', ['plugins', 'list'], {
-    stdio: 'pipe',
-    timeout: 5000,
-    env: { ...process.env, HERMES_PLUGINS_DEBUG: '1' },
-  });
-  const listOutput = list.stdout?.toString() ?? '';
-  const alreadyEnabled = listOutput.includes(PLUGIN_ID) && !listOutput.includes(`${PLUGIN_ID} (disabled)`);
-
-  if (alreadyEnabled) {
-    out.push(`Plugin "${PLUGIN_ID}" is already enabled in Hermes.`);
-    return { exitCode: 0, output: out };
-  }
-
-  if (flags.print) {
-    out.push(`# Will run: hermes plugins enable ${PLUGIN_ID}`);
-    return { exitCode: 0, output: out };
-  }
-
-  if (!flags.yes) {
-    out.push(`Pending: hermes plugins enable ${PLUGIN_ID}`);
-    out.push(``);
-    out.push(`Dry-run only. Re-run with -y to apply.`);
-    return { exitCode: 2, output: out };
-  }
-
-  const result = spawnSync('hermes', ['plugins', 'enable', PLUGIN_ID], {
-    stdio: 'pipe',
-    timeout: 10000,
-  });
-
-  if (result.status !== 0) {
-    out.push(`Failed to enable plugin: ${result.stderr?.toString() ?? result.stdout?.toString() ?? 'unknown error'}`);
-    return { exitCode: 1, output: out };
-  }
-
-  out.push(`Plugin "${PLUGIN_ID}" enabled in Hermes.`);
-  out.push(`Verify: HERMES_PLUGINS_DEBUG=1 hermes plugins list`);
-  return { exitCode: 0, output: out };
-}
-
-export function createSetupHermesSubcommand(): Command {
-  return new Command('hermes')
-    .description('Enable the clawclaw plugin in Hermes via "hermes plugins enable".')
-    .option('-y, --yes', 'Apply changes (default is dry-run)')
-    .option('--print', 'Only print the command that would be run; do not execute')
-    .action((opts: { yes?: boolean; print?: boolean }) => {
-      const result = runHermesSetup({ yes: opts.yes, print: opts.print });
-      for (const line of result.output) console.log(line);
-      if (result.exitCode !== 0) process.exit(result.exitCode);
-    });
-}
+/**
+ * `ccl setup hermes` — enable the clawclaw plugin in Hermes via `hermes plugins enable`.
+ */
+
+import { Command } from 'commander';
+import { spawnSync } from 'child_process';
+
+export const PLUGIN_ID = 'clawclaw';
+
+export interface SetupHermesResult {
+  exitCode: number;
+  output: string[];
+}
+
+export function runHermesSetup(flags: { yes?: boolean; print?: boolean }): SetupHermesResult {
+  const out: string[] = [];
+
+  // Check hermes is available
+  const which = spawnSync('hermes', ['--version'], { stdio: 'pipe', timeout: 5000 });
+  if (which.status !== 0) {
+    out.push('hermes CLI not found. Install it first, then re-run.');
+    return { exitCode: 1, output: out };
+  }
+
+  // Check current plugin status
+  const list = spawnSync('hermes', ['plugins', 'list'], {
+    stdio: 'pipe',
+    timeout: 5000,
+    env: { ...process.env, HERMES_PLUGINS_DEBUG: '1' },
+  });
+  const listOutput = list.stdout?.toString() ?? '';
+  const alreadyEnabled = listOutput.includes(PLUGIN_ID) && !listOutput.includes(`${PLUGIN_ID} (disabled)`);
+
+  if (alreadyEnabled) {
+    out.push(`Plugin "${PLUGIN_ID}" is already enabled in Hermes.`);
+    return { exitCode: 0, output: out };
+  }
+
+  if (flags.print) {
+    out.push(`# Will run: hermes plugins enable ${PLUGIN_ID}`);
+    return { exitCode: 0, output: out };
+  }
+
+  if (!flags.yes) {
+    out.push(`Pending: hermes plugins enable ${PLUGIN_ID}`);
+    out.push(``);
+    out.push(`Dry-run only. Re-run with -y to apply.`);
+    return { exitCode: 2, output: out };
+  }
+
+  const result = spawnSync('hermes', ['plugins', 'enable', PLUGIN_ID], {
+    stdio: 'pipe',
+    timeout: 10000,
+  });
+
+  if (result.status !== 0) {
+    out.push(`Failed to enable plugin: ${result.stderr?.toString() ?? result.stdout?.toString() ?? 'unknown error'}`);
+    return { exitCode: 1, output: out };
+  }
+
+  out.push(`Plugin "${PLUGIN_ID}" enabled in Hermes.`);
+  out.push(`Verify: HERMES_PLUGINS_DEBUG=1 hermes plugins list`);
+  return { exitCode: 0, output: out };
+}
+
+export function createSetupHermesSubcommand(): Command {
+  return new Command('hermes')
+    .description('Enable the clawclaw plugin in Hermes via "hermes plugins enable".')
+    .option('-y, --yes', 'Apply changes (default is dry-run)')
+    .option('--print', 'Only print the command that would be run; do not execute')
+    .action((opts: { yes?: boolean; print?: boolean }) => {
+      const result = runHermesSetup({ yes: opts.yes, print: opts.print });
+      for (const line of result.output) console.log(line);
+      if (result.exitCode !== 0) process.exit(result.exitCode);
+    });
+}

package/src/commands/setup/index.ts

@@ -1,13 +1,13 @@
-import { Command } from 'commander';
-import { createSetupOpenclawSubcommand } from './openclaw.js';
-import { createSetupHermesSubcommand } from './hermes.js';
-import { createSetupCodexSubcommand } from './codex.js';
-
-export function createSetupCommand(): Command {
-  const setup = new Command('setup');
-  setup.description('Install recommended config snippets into agent host config files.');
-  setup.addCommand(createSetupOpenclawSubcommand());
-  setup.addCommand(createSetupHermesSubcommand());
-  setup.addCommand(createSetupCodexSubcommand());
-  return setup;
-}
+import { Command } from 'commander';
+import { createSetupOpenclawSubcommand } from './openclaw.js';
+import { createSetupHermesSubcommand } from './hermes.js';
+import { createSetupCodexSubcommand } from './codex.js';
+
+export function createSetupCommand(): Command {
+  const setup = new Command('setup');
+  setup.description('Install recommended config snippets into agent host config files.');
+  setup.addCommand(createSetupOpenclawSubcommand());
+  setup.addCommand(createSetupHermesSubcommand());
+  setup.addCommand(createSetupCodexSubcommand());
+  return setup;
+}