Start
設定指南
Clawdbot 的完整設定指南，包括安裝、配置和開發工作流程。
儲存位置
Clawdbot 將配置與安裝分離：
| 位置 | 用途 |
|---|---|
~/.clawdbot/workspace | 您的工作區檔案 |
~/.clawdbot/clawdbot.json | 主要配置 |
~/.clawdbot/credentials/ | 認證令牌 |
這種分離允許輕鬆更新而不破壞個人配置。
先決條件
- Node.js >= 22
- pnpm（建議）或 npm
- Docker（選用，用於容器化設定）
安裝方式
快速安裝（建議）
curl -fsSL https://clawd.bot/install.sh | bash透過 npm
npm i -g clawdbot
clawdbot setup透過 pnpm
pnpm add -g clawdbot
clawdbot setup工作流程
穩定工作流程（macOS 應用程式）
對於大多數使用者，macOS 應用程式提供最簡單的體驗：
- 安裝 - 下載並啟動 Clawdbot.app
- 引導 - 完成設定精靈
- 權限 - 授予所需的系統存取
- 閘道器模式 - 確保閘道器處於本地模式
- 頻道 - 連結通訊頻道（WhatsApp、Telegram 等）
- 驗證 - 執行
clawdbot health確認設定
開發工作流程
適用於貢獻者和進階使用者：
# 複製儲存庫
git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot
# 安裝依賴
pnpm install
# 啟動帶有熱重載的開發閘道器
pnpm gateway:watch將 macOS 應用程式設定為本地連接模式。應用程式會連接到在設定的連接埠上執行的閘道器（預設：ws://127.0.0.1:18789）。
憑證儲存
| 類型 | 位置 |
|---|---|
~/.clawdbot/credentials/whatsapp/<accountId>/creds.json | |
| Telegram | ~/.clawdbot/credentials/telegram/ |
| 對話階段 | ~/.clawdbot/agents/<agentId>/sessions/ |
| OAuth | ~/.clawdbot/credentials/oauth.json |
| 日誌 | /tmp/clawdbot/ |
平台說明
macOS
應用程式透過 LaunchAgent 自動管理閘道器。
Linux
使用 systemd 使用者服務。啟用 lingering 以防止登出時服務關閉：
sudo loginctl enable-linger $USERWindows (WSL2)
在 WSL2 中使用 Linux 發行版執行 Clawdbot。設定方式與 Linux 相同。
更新策略
將個人內容保存在 ~/.clawdbot/ 目錄中，與安裝分離：
# 透過 npm 更新
npm update -g clawdbot
# 或拉取最新原始碼
cd clawdbot
git pull
pnpm install您的工作區和配置在更新後保持不變。
健康檢查
驗證您的安裝：
clawdbot health預期輸出：
- 閘道器狀態：執行中
- 連接埠：18789
- 頻道：已連接
- 代理：就緒
疑難排解
閘道器無法啟動
- 檢查連接埠 18789 是否被使用：
lsof -i :18789 - 查看日誌：
cat /tmp/clawdbot/gateway.log - 重設配置：
clawdbot configure --reset
頻道連線問題
- 重新認證：
clawdbot channels login - 檢查憑證：
ls ~/.clawdbot/credentials/ - 驗證允許清單：檢查
clawdbot.json