Start
建立個人助理
使用 WhatsApp、Telegram、Discord 或 iMessage 將 Clawdbot 設定為您的個人 AI 助理。
概述
Clawdbot 是一個連接訊息平台與 AI 代理的閘道器，讓您可以透過喜愛的訊息應用程式與 AI 助理互動。
安全注意事項
Clawdbot 可以執行指令、存取檔案和發送訊息。重要的安全措施：
- 設定
channels.whatsapp.allowFrom來限制存取 - 為助理使用專用的電話號碼
- 在信任之前先停用心跳功能（
"0m"） - 授予 shell 存取權限前先檢查權限
先決條件
- Node.js 22+
- 全域安裝的 Clawdbot
- 為助理準備第二個電話號碼（建議）
建議架構
使用兩部手機是最安全的設定：
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│ 您的手機 │────▶│ 助理 │────▶│ 您的電腦 │
│ （個人） │ │ 電話號碼 │ │ (Clawdbot) │
└─────────────────┘ └─────────────────┘ └─────────────────┘您的個人裝置發送訊息到第二支手機（助理），該手機連結到您電腦上執行的 Clawdbot。
快速開始
1. 配對 WhatsApp Web
clawdbot channels login whatsapp使用您的助理手機掃描 QR 碼。
2. 啟動閘道器
clawdbot gateway --port 187893. 設定允許清單
編輯 ~/.clawdbot/clawdbot.json：
{
"channels": {
"whatsapp": {
"allowFrom": ["+1234567890"],
"dmPolicy": "allowlist"
}
}
}工作區與記憶
預設工作區
位置：~/.clawdbot/workspace
包含指令檔案：
| 檔案 | 用途 |
|---|---|
AGENTS.md | 代理設定和行為 |
SOUL.md | 個性和溝通風格 |
TOOLS.md | 可用工具和功能 |
IDENTITY.md | 身份資訊 |
USER.md | 關於您的資訊 |
HEARTBEAT.md | 主動任務指令 |
版本控制
將您的工作區作為 git 儲存庫進行備份：
cd ~/.clawdbot/workspace
git init
git add .
git commit -m "Initial workspace"對話階段
對話階段按發送者儲存。管理對話階段的指令：
| 指令 | 描述 |
|---|---|
/new | 開始新對話 |
/reset | 清除對話歷史 |
/status | 檢查助理狀態 |
心跳（主動任務）
心跳是代理定期檢查 HEARTBEAT.md 以獲取任務的機制。
設定
在 ~/.clawdbot/clawdbot.json 中：
{
"heartbeat": {
"interval": "30m",
"enabled": true
}
}行為
- 預設：每 30 分鐘
- 代理讀取
HEARTBEAT.md以獲取待處理任務 - 如果沒有需要關注的事項，回應
HEARTBEAT_OK - 設定為
"0m"以停用
HEARTBEAT.md 範例
# 心跳任務
- 檢查新郵件並摘要重要郵件
- 查看日曆上的即將會議
- 監控 AAPL、GOOGL 的股票價格媒體處理
接收附件
Clawdbot 可以接收和處理：
- 圖片
- 文件
- 語音訊息
- 影片
發送媒體
使用 MEDIA:<path> 語法發送媒體：
MEDIA:/path/to/image.png操作
狀態指令
# 檢查健康狀態
clawdbot health
# 查看狀態
clawdbot status
# 檢查日誌
tail -f /tmp/clawdbot/gateway.log日誌記錄
日誌儲存在 /tmp/clawdbot/：
| 檔案 | 內容 |
|---|---|
gateway.log | 閘道器操作 |
agent.log | 代理活動 |
channel-*.log | 頻道特定日誌 |
多頻道設定
在 clawdbot.json 中設定多個頻道：
{
"channels": {
"whatsapp": {
"enabled": true,
"allowFrom": ["+1234567890"]
},
"telegram": {
"enabled": true,
"botToken": "YOUR_BOT_TOKEN"
},
"discord": {
"enabled": true,
"botToken": "YOUR_BOT_TOKEN"
}
}
}