Start
引導精靈 (CLI)
使用 CLI 精靈配置 Clawdbot，透過引導式設定閘道器、頻道、技能和工作區預設值。
概述
引導精靈是在 macOS、Linux 或 Windows（透過 WSL2）上設定 Clawdbot 的建議方式。它提供本地或遠端閘道器連接、頻道、技能和工作區預設值的引導配置流程。
主要指令
| 指令 | 描述 |
|---|---|
clawdbot onboard | 主要設定精靈 |
clawdbot dashboard | 開啟控制 UI 以進行瀏覽器聊天 |
clawdbot configure | 重新配置現有安裝 |
clawdbot configure --section web | 配置網路搜尋（Brave Search API） |
設定模式
快速啟動（建議）
適用於大多數使用者的預設配置：
- 回環地址上的本地閘道器
- 連接埠 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. 閘道器配置
配置您的閘道器設定：
- 連接埠：預設 18789
- 綁定地址：回環或網路
- 認證模式：令牌式（建議）
- Tailscale：選擇性遠端暴露
5. 頻道設定
選擇性整合：
- Telegram
- Discord
- Slack
- Signal
- iMessage
- Google Chat
- Mattermost
6. 守護程式安裝
- macOS：LaunchAgent
- Linux/WSL2：systemd 使用者單元
7. 健康檢查
驗證閘道器啟動和連線能力。
8. 技能安裝
透過 npm/pnpm 安裝選擇性技能套件。
遠端模式
連接到在其他地方執行的現有閘道器：
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每個代理都有自己的工作區和配置。