Clawdbot 部署步骤详解

Clawdbot 部署步骤详解（2026 年最新版，基于官方文档和 GitHub）Clawdbot 是一个开源的个人 AI 代理（本质上是“Claude + 超级工具链 + 多渠道聊天 + 永久记忆 + 主动性”），部署后它能通过 WhatsApp/Telegram/iMessage 等聊天软件直接跟你互动，还能读写邮件、日历、浏览器自动化、写代码等。配置文件默认在 ~/.clawdbot/cla

sun_hui_1982

1833人浏览 · 2026-01-27 09:40:16

sun_hui_1982 · 2026-01-27 09:40:16 发布

它有完整系统权限（读写文件、跑 shell、控制浏览器），风险很高！强烈建议先在虚拟机或隔离环境测试。
吃 token 很猛，用 Claude Opus/Claude 4 的话一天几十到几百刀正常。
官方文档（强烈推荐先读）：https://docs.clawd.bot/ （尤其是 /start/getting-started 和 /install）
GitHub: https://github.com/clawdbot/clawdbot

前置要求

操作系统：
- macOS 14+（最友好，有配套菜单栏 App）
- Linux（推荐 VPS 或本地服务器，Ubuntu/Debian 最佳）
- Windows：必须用 WSL2（Ubuntu）部署，纯 Windows 不推荐
Node.js：≥ v22（推荐 v22 或 v23 LTS）
包管理器：pnpm（首选）或 npm / bun
Git：用于从源码安装
可选：Docker（沙箱模式运行工具，避免权限过大）
API Key：至少准备 Anthropic（Claude）API key，推荐 Claude-3.5-Sonnet 或 Opus（代码能力强）。可选 OpenAI、Groq、本地模型
硬件：普通笔记本即可，VPS 建议至少 2 vCPU + 4GB 内存（e2-small 就够）

推荐部署方式：一键安装（5-10 分钟上手）适用于 macOS / Linux / WSL2

运行一键脚本（自动安装 Node、pnpm、Clawdbot CLI 等） bash
```
curl -fsSL https://clawd.bot/install.sh | bash
```
- 脚本会检测系统、安装依赖、创建 ~/.clawdbot 目录
- 完成后会提示 exec bash 或重开终端
运行 onboarding 向导（最关键一步！） bash
```
clawdbot onboard --install-daemon
```
- --install-daemon 会把 Gateway 设置成后台服务（macOS 用 launchd，Linux 用 systemd）
- 向导会问你：
  - 选择模型提供商（Anthropic / OpenAI / Groq / 本地）
  - 输入 API Key
  - 配置聊天渠道（WhatsApp、Telegram、Signal、Discord、Slack、iMessage 等）
  - 设置工作区、偏好（思考深度、主动提醒等）
  - 绑定手机/电脑（WhatsApp 需要扫码登录，Signal 需要 signal-cli）

验证安装 bash

clawdbot doctor          # 检查配置、权限、API 连通性
clawdbot gateway status  # 查看 Gateway 是否运行

测试发送消息
- 通过 CLI： bash
```
clawdbot message send --to +1234567890 --message "测试：你好 Clawdbot"
```
- 或直接在 WhatsApp/Telegram 发消息给你的 Clawdbot 号码：“今天天气怎么样？”
启动/重启 Gateway（如果没用 daemon） bash
```
clawdbot gateway --port 18789 --verbose
```

其他安装方式方式2：全局 NPM / PNPM 安装（适合已装好 Node 的用户）bash

pnpm add -g clawdbot@latest   # 或 npm i -g clawdbot@latest
clawdbot onboard --install-daemon

方式3：从源码开发/自定义（推荐极客）bash

git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot
pnpm install
pnpm ui:build              # 第一次构建 UI
pnpm build
pnpm clawdbot onboard --install-daemon
# 开发模式（热重载）
pnpm gateway:watch

配置渠道（Channels）详解

WhatsApp：运行 clawdbot channels login whatsapp → 扫码链接（类似 WhatsApp Web）
Telegram：创建 Bot 获取 token → 在 onboarding 或 ~/.clawdbot/clawdbot.json 配置
Signal：需安装 signal-cli，配置手机号
iMessage：macOS 专用，需 Messages App 已登录
Discord/Slack：创建 App，填 Bot Token
多渠道：可以同时开启多个，Clawdbot 会统一管理

配置文件默认在 ~/.clawdbot/clawdbot.json 和 ~/.clawdbot/credentials，记得备份！云端部署（VPS / DigitalOcean / GCP / Render）

租一台 Ubuntu 22.04+ VPS（推荐 DigitalOcean 最低 $6/月）
SSH 登录，运行一键脚本
clawdbot onboard --install-daemon
用 Tailscale / Cloudflare Tunnel / SSH 反代暴露 Gateway（端口 18789）
手机/电脑从远程连接（ws://你的公网IP:18789）
官方有 Render.yaml、fly.toml、GCP 实例创建指南

常见问题 & 排障

Daemon 不启动：systemctl --user status clawdbot（Linux）或 launchctl list | grep clawdbot（macOS）
权限问题：macOS 需要 TCC 授权（屏幕录制、文件访问、AppleScript 等）
API 连不上：检查 Key 是否过期，跑 clawdbot doctor
吃 token 太快：调低思考深度（--thinking medium），用 Sonnet 代替 Opus
安全：永远别在 root 下跑！沙箱模式用 Docker（Dockerfile.sandbox）
更新：clawdbot update 或重新跑 install.sh

后续建议