问我AI

在脚本和 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无法连接服务器、没有权限,或服务器版本太旧
6team apply --check 发现了变更
7doctor --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 客户端使用。

这篇有帮助吗?
没有找到答案?告诉我们