Clawdbot 深度指南

Clawdbot 是一个开源的个人 AI 助手，由 Peter Steinberger 创建。它运行在您的设备上，能够主动与您互动，处理日常任务，如清理收件箱、发送邮件、管理日历、航班值机等。它支持多种消息平台（如 WhatsApp、Telegram、Slack、Discord 等），并可与本地系统集成，提供浏览器控制、文件访问和自动化功能。本指南将详细介绍 Clawdbot 的安装、使用和高级功能，帮助您从入门到熟练掌握。

1. Clawdbot 简介

Clawdbot 不是一个被动等待指令的 AI，而是主动的“数字员工”。它运行在您的电脑或服务器上，使用大型语言模型（LLM，如 Anthropic 的 Claude 或 OpenAI 的 GPT）来理解和执行任务。核心理念是“本地优先”：所有数据和配置存储在您的设备上，确保隐私和控制权。

• • 为什么选择 Clawdbot？
  • • 主动性：它会先发消息提醒您，而不是只响应查询。
  • • 跨平台：支持 Mac、Windows、Linux，甚至 Raspberry Pi。
  • • 集成丰富：连接 50+ 服务，如 Gmail、Spotify、Philips Hue、Notion、Todoist 等。
  • • 开源：GitHub 上有 23k+ 星标，用户可自定义修改。
  • • 成本低：基本运行只需 $5/月（模型 API 费用），无订阅费。

Clawdbot 的灵感来源于“龙虾方式”（lobster way），象征其坚韧和适应性。它可以成为您的“第二大脑”，记住偏好、自动化流程，并通过技能扩展功能。

（Clawdbot 的标志性龙虾主题图像，来源网络搜索。）

2. 主要特性

Clawdbot 的功能强大而灵活，以下是核心亮点：

• • 消息通道支持：WhatsApp、Telegram、Slack、Discord、Google Chat、Signal、iMessage、Microsoft Teams 等。支持群聊和 DM，支持语音交互（macOS/iOS/Android）。
• • 工具和自动化：
  • • 浏览器控制：浏览网页、填写表单、提取数据、使用专用 Chrome 实例。
  • • 系统访问：读写文件、运行 shell 命令、执行脚本（可选沙箱模式）。
  • • 节点（Nodes）：相机拍摄、屏幕录制、位置获取、通知推送。
  • • Cron 任务：定时提醒、背景任务、Gmail 推送订阅。
  • • 技能（Skills）：内置、社区或自定义技能，如 WHOOP 集成、RSS 订阅处理。
• • AI 能力：
  • • 支持多种模型：Anthropic Claude、OpenAI GPT、本地模型。
  • • 持久记忆：通过 Markdown 文件存储上下文，每天总结笔记。
  • • 自我改进：AI 可安装新技能、生成代码、优化自身。
• • 安全与隐私：默认本地运行，支持沙箱隔离群聊会话。DM 需要配对代码验证。
• • 伴侣应用：macOS 菜单栏应用（beta）、iOS/Android 节点，用于语音唤醒和画布（Canvas）交互。
• • 主动功能：心跳检测、每日报告（如日历总结、Todoist 项目创建）。

用户反馈称其“像魔法一样”，例如 Federico Viticci 在 MacStories 中描述：它能控制 Spotify、生成图像、转录音频，并替换 Zapier 自动化。

3. 系统要求

• • 运行时：Node.js ≥ 22。
• • 操作系统：macOS、Linux、Windows（推荐 WSL2）。
• • 硬件：最低 Raspberry Pi 或云服务器；推荐 M1+ Mac 或类似，以支持快速响应。
• • 模型订阅：Anthropic Claude Pro/Max（推荐 Opus 4.5）或 OpenAI API 密钥。
• • 可选：Docker（用于沙箱）、Tailscale（远程访问）、ElevenLabs（TTS 语音）。

4. 安装和设置

Clawdbot 的安装简单，通过 CLI 向导完成。以下是步骤：

步骤 1: 安装 Clawdbot

使用一键脚本（macOS/Linux/Windows）：

curl -fsSL https://clawd.bot/install.sh | bash

或通过 NPM：

npm install -g clawdbot@latest

（或使用 pnpm/bun：pnpm add -g clawdbot@latest）

从源代码安装（高级用户）：

git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot
pnpm install
pnpm ui:build
pnpm build
pnpm clawdbot onboard

步骤 2: 运行向导

clawdbot onboard --install-daemon

向导会引导您：

• • 配置 Gateway（控制平面，端口默认 18789）。
• • 设置工作区（workspace，默认 ~/clawd）。
• • 添加通道（如 Telegram：提供 BOT_TOKEN）。
• • 配置模型（推荐 Anthropic：登录 OAuth）。
• • 安装守护进程（launchd/systemd），确保 24/7 运行。

对于 Docker 安装：参考 https://docs.clawd.bot/install/docker。

步骤 3: 连接通道

例如，Telegram：

• 创建 Bot 并获取 TOKEN。

• 在 ~/.clawdbot/clawdbot.json 中添加：

{
  "channels": {
    "telegram": {
      "botToken": "YOUR_TOKEN"
    }
  }
}

• 登录其他通道：clawdbot channels login（如 WhatsApp 扫码）。

步骤 4: 启动 Gateway

clawdbot gateway --port 18789 --verbose

测试发送消息：

clawdbot message send --to +1234567890 --message "Hello from Clawdbot"

更新 Clawdbot：clawdbot update --channel stable。

伴侣应用：从 GitHub 下载 macOS app（beta），用于菜单栏控制和语音唤醒。

5. 配置

配置文件在 ~/.clawdbot/clawdbot.json。最小配置：

{
  "agent": {
    "model": "anthropic/claude-opus-4-5"
  }
}

高级选项：

• • 模型故障转移：添加备用模型。
• • DM 策略：dmPolicy: "pairing"（默认，需要配对代码）。
• • 沙箱：agents.defaults.sandbox.mode: "non-main"（群聊隔离）。
• • Tailscale：启用远程访问（serve/funnel 模式）。
• • 技能：从 ClawdHub 安装（https://clawdhub.com）。

运行 clawdbot doctor 检查配置问题。

6. 使用 Clawdbot

基本互动

通过消息应用发送指令，如 Telegram：

• • "清理我的收件箱"：Clawdbot 会访问 Gmail 并总结。
• • "设置提醒：明天 9am 会议"：创建 cron 任务。
• • 语音输入：支持转录（Groq Whisper）。

聊天命令（在通道中输入）：

• • /status：查看会话状态（令牌、成本）。
• • /new：重置会话。
• • /think high：调整思考级别（minimal/low/medium/high）。
• • /verbose on：启用详细输出。
• • /activation mention：群聊激活模式（需 @ 提及）。

示例

• • 每日报告：配置 cron 让 Clawdbot 发送日历总结、Todoist 任务，并生成音频版本。
• • 图像生成："生成一张龙虾 AI 的图片" – 使用 Google Nano Banana Pro。
• • 自动化："检查 RSS 并创建 Todoist 项目" – Clawdbot 会研究 API 并实现。

Clawdbot 会记住您的偏好，如语言（支持意大利语/英语）和集成（Notion/Todoist）。

7. 高级功能

技能和插件

• • 内置技能：浏览器、画布、节点、cron。
• • 安装新技能：AI 可自动从 ClawdHub 拉取，或手动添加 Markdown 文件到 ~/clawd/skills。
• • 示例：集成 Spotify – Clawdbot 会请求凭证、存储在 Keychain，并控制播放。

工具使用

• • 浏览器：tool: browser – 导航网页、截图。
• • 画布（Canvas）：实时视觉工作区，使用 A2UI 渲染 UI。
• • 节点：在 iOS/Android 上运行 node.invoke 获取位置或录屏。
• • 会话工具：sessions_list / sessions_send – 跨会话协调。

自动化和主动性

• • Cron：设置定时任务，如 "每小时检查心跳"。
• • Webhooks：接收外部事件。
• • 自我 hacking：让 Clawdbot 修改自身代码（小心使用）。

安全提示：群聊使用沙箱，避免工具滥用。

8. 故障排除

• • 常见问题：运行 clawdbot doctor 检查权限、配置。
• • 日志：clawdbot gateway --verbose 查看详细输出。
• • 通道问题：参考 https://docs.clawd.bot/channels/troubleshooting。
• • 模型错误：检查 API 密钥，确保故障转移。
• • 社区：加入 Discord (https://discord.gg/clawd) 求助。

文档：https://docs.clawd.bot – 覆盖所有主题。

9. 结论

Clawdbot 代表了个人 AI 的未来：一个可 hack、可信赖的助手，能主动提升您的生产力。通过本指南，您可以快速上手，并探索其无限潜力。用户如 Federico Viticci 称其为“根本性转变”，它不仅仅是工具，更是您的 AI 队友。开始您的 Clawdbot 之旅吧！

如果需要更多自定义，查看 GitHub 仓库或 ClawdHub 技能库。