Start
引导向导 (CLI)
使用 CLI 向导配置 Clawdbot，引导设置 Gateway、频道、技能和工作区默认值。
概述
引导向导是在 macOS、Linux 或 Windows（通过 WSL2）上设置 Clawdbot 的推荐方法。它提供了本地或远程 Gateway 连接、频道、技能和工作区默认值的引导配置流程。
关键命令
| 命令 | 描述 |
|---|---|
clawdbot onboard | 主要设置向导 |
clawdbot dashboard | 打开控制台 UI 进行浏览器聊天 |
clawdbot configure | 重新配置现有安装 |
clawdbot configure --section web | 配置网络搜索（Brave Search API） |
设置模式
快速开始（推荐）
适合大多数用户的默认配置：
- 本地 Gateway 在回环地址
- 端口 18789，使用令牌认证
- Telegram/WhatsApp 私信使用白名单模式
高级模式
为高级用户提供所有配置步骤的完全控制。
配置流程
1. 检测现有配置
向导检测 ~/.clawdbot/clawdbot.json 并提供选项：
- 保留 - 使用现有配置
- 修改 - 更新特定设置
- 重置 - 重新开始
2. 模型与认证
选择你的 AI 提供商：
| 提供商 | 描述 |
|---|---|
| Anthropic API Key | 推荐，性能最佳 |
| Anthropic OAuth | 适用于 Claude Pro/Max 订阅者 |
| OpenAI API Key | GPT-4 和其他模型 |
| OpenAI Codex | 代码专用订阅 |
| Vercel AI Gateway | 代理选项 |
| 本地模型 | 离线运行 |
3. 工作区设置
默认工作区：~/.clawdbot/workspace
创建的引导文件：
AGENTS.md- 代理配置SOUL.md- 个性设置TOOLS.md- 可用工具IDENTITY.md- 身份信息
4. Gateway 配置
配置你的 Gateway 设置：
- 端口：默认 18789
- 绑定地址：回环或网络
- 认证模式：基于令牌（推荐）
- Tailscale：可选的远程暴露
5. 频道设置
可选集成：
- Telegram
- Discord
- Slack
- Signal
- iMessage
- Google Chat
- Mattermost
6. 守护进程安装
- macOS：LaunchAgent
- Linux/WSL2：systemd 用户单元
7. 健康检查
验证 Gateway 启动和连接性。
8. 技能安装
通过 npm/pnpm 安装可选技能包。
远程模式
连接到其他地方运行的现有 Gateway：
clawdbot onboard --remote不在远程主机上执行安装 - 仅配置本地客户端连接。
非交互模式
用于自动化和脚本：
clawdbot onboard --non-interactive \
--auth-choice anthropic \
--anthropic-api-key $ANTHROPIC_API_KEY多代理
创建隔离的代理实例：
clawdbot agents add work
clawdbot agents add personal
clawdbot agents list每个代理都有自己的工作区和配置。