快速开始

1. 初始化

weavbot onboard

会创建 WB_DATA_PATH/config.json 和 WB_DATA_PATH/workspace/（默认 WB_DATA_PATH=~/.weavbot），并启动交互式配置向导，依次完成：

服务商选择 — 从 models.dev 拉取已知服务商与模型，选择服务商、模型并填写 API 密钥
渠道配置 — 配置聊天渠道（Telegram、Discord、飞书、钉钉、Slack、QQ、企业微信（Wecom）、Email、Mochat）的凭证
依赖安装 — 检测并在缺失时安装 ripgrep（代理文件搜索工具所需）到 ~/.weavbot/bin/
开机自启 — 配置网关在登录后自动启动（Linux 用 systemd，macOS 用 launchd，Windows 用 traycli）

向导会根据系统语言自动选择提示语言，必要时显示中文。可通过 WB_LANG=en 或 WB_LANG=zh 覆盖。 CLI 翻译已拆分到独立的 weavbot.i18n 包，当前采用 cli.setup.* 与 cli.commands.* 这类 key 命名空间，便于后续扩展。选择器支持方向键移动和输入过滤。若实时选择器不可用（如非 TTY 终端），onboard 会自动回退到数字编号选择模式。

也可使用 --set 在命令行内联配置（可重复，类似 Helm）：

weavbot onboard \
  --set providers.anthropic.apiKey=sk-ant-xxx \
  --set providers.anthropic.mode=anthropic \
  --set agents.defaults.model=claude-sonnet-4-20250514 \
  --set agents.defaults.provider=anthropic

键为与 JSON 配置结构对应的点分 camelCase 路径，值会自动推断类型（数字、布尔、null）或按字符串处理。

2. 配置

也可直接编辑 WB_DATA_PATH/config.json（默认 ~/.weavbot/config.json）设置 API 密钥和模型。

服务商为扁平对象，键为自定名称，每项包含 mode（"openai" 或 "anthropic"）及凭证：

{
  "providers": {
    "anthropic": {
      "mode": "anthropic",
      "apiKey": "sk-ant-xxx"
    },
    "openrouter": {
      "apiKey": "sk-or-v1-xxx",
      "apiBase": "https://openrouter.ai/api/v1"
    },
    "deepseek": {
      "apiKey": "sk-xxx",
      "apiBase": "https://api.deepseek.com/v1"
    }
  },
  "agents": {
    "defaults": {
      "model": "claude-sonnet-4-20250514",
      "provider": "anthropic"
    }
  }
}

mode 默认为 "openai"（OpenAI 兼容 API），设为 "anthropic" 使用原生 Anthropic API
agents.defaults.provider 必须与 providers 中的某个键一致

所有渠道与工具配置见配置说明一节。

3. 运行

weavbot gateway

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

安装

开机自启

命令参考