在脚本和 CI 中运行 WenwoBot
wenwobot 命令可以在没有界面的情况下操作一个正在运行的工作区:从文件设置团队、给机器人派活、等待它以及它请来的所有队友完成,并保存它们的成果。它既可以操作这台电脑上的服务器,也可以操作别处的服务器,专为脚本、CI 和其他智能体设计:每个命令都可以只输出一个 JSON 文档,退出码说明结果如何。
npm install -g wenwobot # 或者使用 npx wenwobot …
wenwobot serve --no-pair & # 启动一个没有界面的工作区(也可以直接用桌面应用)
wenwobot engine set claude --key-env ANTHROPIC_API_KEY
wenwobot team apply launch-room.yaml
wenwobot run "Room Lead" "Rehearse the launch of https://example.com" --export ./rehearsal
run 会边执行边输出进度,最后输出负责人的最终回复和它链接的文件,并把所有内容写入 ./rehearsal。
连接哪个工作区、以什么身份
--url URL或环境变量OPENWENWOBOT_URL:别处的工作区。https://任何地方都可以用;普通的http://只能用于这台电脑或私有网络(局域网地址、Tailscale 的 100.x 或*.ts.net、*.local)。--port N或WWB_PORT:这台电脑上的指定端口。- 否则会在这台电脑常用的端口(8799、18799、28799)上查找,与桌面应用相同。
在这台电脑上,无界面服务器会把你当作所有者,不需要令牌。在其他地方则需要令牌:
wenwobot connect https://wenwobot.example.com --code 7KQ2-M9XD-H4TP --out ~/.wenwobot-token
wenwobot doctor --url https://wenwobot.example.com --token-file ~/.wenwobot-token
在服务器上用 wenwobot pair 生成配对码(加上 --client --ttl 24h 可以生成只能聊天、最长一天有效的配对码;每个配对码只能用一次)。令牌只会写入只有你能读的文件,从不输出到屏幕。用 --token-file FILE 或环境变量 OPENWENWOBOT_TOKEN 传入令牌;没有 --token 参数,因为命令行可能被其他程序读到。
为 CI 创建一个到指定日期失效的访问令牌:
wenwobot token create "Nightly CI" --scope client --expires 90d --out ci-token
wenwobot token list # 名称、范围、失效日期、最近使用时间(从不显示令牌本身)
wenwobot token revoke ID # 立即失效
connect 得到的会话在使用期间会自动续期,最长 180 天;访问令牌不会续期,到期即失效。--scope client(默认)可以聊天和回答审批,但不能修改设置。
输出与退出码
不加 --json 时输出普通文本;加上 --json 时,标准输出只有一个 JSON 文档,失败时也是({ "ok": false, "error", "hint", "exitCode" })。进度以每行一个 JSON 对象输出到标准错误,--quiet 可以关闭。所有输出都会去除敏感信息。时长可以写成 90、90s、5m、2h 或 30d。
| 退出码 | 含义 |
|---|---|
| 0 | 完成 |
| 1 | 失败、已停止或卡住,或某一步被拒绝 |
| 2 | 命令行参数或文件有误 |
| 3 | 需要有人回答(问题或审批卡片) |
| 4 | 超时(工作仍在继续) |
| 5 | 无法连接服务器、没有权限,或服务器版本太旧 |
| 6 | team apply --check 发现了变更 |
| 7 | doctor --host:这台机器缺少服务器需要的组件 |
| 130 | 按了 Ctrl-C(工作仍在继续) |
常用命令
对任意命令运行 wenwobot help 命令名 查看帮助。TARGET 是机器人或群组的名称或 ID,也可以用 --bot ID、--channel ID 或 --thread ID;--task ID 选择其中一个对话。
| 命令 | 作用 |
|---|---|
doctor [--wait 2m] | 检查服务器是否响应、版本是否足够新、你在服务器上的身份(以及会话何时过期)、是否有可用引擎,以及机器人是否有浏览器。 |
doctor --host | 检查这台 Linux 机器能否运行服务器和机器人沙箱。 |
bots、channels、models | 你的机器人及其状态、你的群组、引擎及其模型。 |
messages TARGET [--limit 30] | 某个对话的最新消息。 |
send TARGET TEXT | 发送一条消息后立即返回。--task new 为它新开一个对话;--send-id ID 让重试变得安全:同一个 ID 不会发送两次。 |
run TARGET TEXT | 给机器人或群组一项工作,并等待完成。 |
wait TARGET | 等待已经在进行的工作。 |
interrupt TARGET [--tree] | 相当于按下停止。--tree 还会停止仍在为这项工作忙碌的所有队友。 |
WenwoBot 的 MCP 服务器 也提供同样的操作,供其他 MCP 客户端使用。