命令参考

命令	说明
weavbot onboard [--set key=value]	初始化配置与工作区
weavbot gateway	启动网关
weavbot agent	交互式对话
weavbot agent -m "..."	发送单条消息
weavbot wechat list-accounts	列出已保存的微信账号

weavbot onboard

安装后建议第一条执行命令就是 onboard。

weavbot onboard

初始化内容

• 创建 WB_DATA_PATH/config.json（默认 ~/.weavbot/config.json）
• 创建 WB_DATA_PATH/workspace/（默认 ~/.weavbot/workspace/）
• 启动服务商/模型/渠道的交互式配置向导
• 可选安装 ripgrep 与配置开机自启

交互选择行为

• 实时过滤： 服务商、模型、渠道选择都支持方向键移动与输入过滤。
• 渠道单选： 每次向导只选择一个渠道，随后填写该渠道字段。
• Ctrl+C 语义：
  • 服务商选择：跳过服务商配置
  • 模型选择：回到服务商选择
  • 渠道选择与字段输入：跳过渠道配置
• 兼容模式回退： 若实时选择器不可用（例如非 TTY 终端），自动回退到数字编号选择模式。

--set 脚本化配置

可重复传入 --set key=value，用于非交互或自动化场景：

weavbot onboard \
  --set providers.openrouter.apiKey=sk-or-v1-xxx \
  --set providers.openrouter.apiBase=https://openrouter.ai/api/v1 \
  --set providers.openrouter.mode=openai \
  --set agents.defaults.provider=openrouter \
  --set agents.defaults.model=openai/gpt-4o-mini

值会尽量自动推断类型（true、false、数字、null），其余按字符串处理。

weavbot gateway

启动常驻网关，管理代理、渠道、定时任务与心跳。

选项	说明
--verbose、-v	启用调试日志

weavbot agent

与代理直接交互。

选项	说明
--message、-m	发送单条消息后退出
--session、-s	会话 ID（默认 cli:direct）
--markdown / --no-markdown	以 Markdown 渲染输出（默认启用）
--logs / --no-logs	聊天时显示运行日志（默认关闭）

weavbot wechat

weavbot wechat login

扫码登录并保存微信账号凭据。

weavbot wechat login

选项	说明
--account、-a	保存到 channels.wechat.accounts 的账号键名
--base-url	微信 API 地址（默认使用内置默认地址）
--route-tag	可选 SKRouteTag 请求头
--timeout-ms	二维码登录超时（毫秒，默认 480000）

weavbot wechat list-accounts

列出已保存的微信账号记录。

weavbot wechat list-accounts

聊天命令

在交互式对话或任意聊天渠道（Telegram、Discord 等）中可使用斜杠命令：

命令	说明
/new	开始新对话（先归档长期记忆，再清空会话）
/stop	停止当前正在执行的任务（含子代理）
/help	显示可用命令

快速开始

配置