个人必看的 Clawdbot 本地部署完全指南（2026版）
发布人 Brave 2026-01-26 02:23
目录
- 一、什么是 Clawdbot
- 1.1 认识 Clawdbot
- 1.2 Clawdbot 与传统 AI 助手的本质区别
- 1.3 Clawdbot 能做什么？
- 二、准备工作
- 2.1 硬件要求
- 2.2 软件环境要求
- 2.3 获取 AI 模型的 API Key
- 三、安装 Clawdbot（分系统详解）
- 3.1 macOS 安装
- 3.2 Windows 安装
- 3.3 Linux 安装（Ubuntu/Debian）
- 3.4 Docker 安装（高级用户/服务器部署）
- 3.5 从源码安装（开发者）
- 四、配置详解
- 4.1 配置 AI 模型（以 Anthropic Claude 为例）
- 4.2 配置消息通道
- 4.3 安全设置：DM 权限控制
- 五、访问本地控制台
- 5.1 启动 Gateway
- 5.2 打开 Web 控制台
- 六、技能（Skills）与扩展
- 6.1 理解 Clawdbot 的能力系统
- 6.2 技能的存放位置
- 6.3 使用 ClawdHub 安装社区技能
- 6.4 常用内置技能示例
- 七、日常使用指南
- 7.1 基本对话
- 7.2 常用命令
- 7.3 远程访问（可选）
- 八、常见问题排查
- 问题 1：安装后提示"command not found: clawdbot"
- 问题 2：Gateway 无法启动
- 问题 3：提示"No API key found for provider 'anthropic'"
- 问题 4：WhatsApp 二维码扫描后无反应
- 问题 5：Claude Code OAuth Token 报错
- 九、进阶配置
- 9.1 使用本地大模型（Ollama）
- 9.2 多 Agent 配置
- 9.3 编写自定义技能
- 十、最佳实践与建议
- 安全建议
- 性能优化
- 使用技巧
- 附录
- 参考资源
一、什么是 Clawdbot
1.1 认识 Clawdbot
Clawdbot 是一个完全开源、可以在你自己设备上运行的私人 AI 助手。 它由开发者 Peter 于 2026 年 1 月正式开源，短短数周内便成为 AI 社区最受关注的项目之一。
为什么叫"龙虾"（Lobster Way）？
Clawdbot 的名字来源于"Claw"（龙虾钳）与"Bot"的组合，其官方吉祥物是一只可爱的龙虾。这个命名寓意着它像龙虾钳一样强大有力，能够精准地抓取和处理各种任务。
1.2 Clawdbot 与传统 AI 助手的本质区别
1.3 Clawdbot 能做什么？
Clawdbot 不仅仅是一个聊天机器人，它是一个真正的"数字员工"：
多平台消息响应
- 支持 WhatsApp、Telegram、Discord、Slack、Signal、iMessage、微信（通过第三方桥接）等 50+ 平台
- 你在任何聊天软件里 @它 或私聊它，它都能响应
持久记忆系统
- 记忆以 Markdown 文件形式存储在本地，类似 Obsidian 知识库
- 它能记住你的偏好、过往对话、重要信息
- 不会像普通 AI 那样"失忆"
主动行动能力
- 定时提醒、日程汇报、新闻摘要
- 监控任务并主动通知你结果
- 可以执行终端命令、编写并运行脚本、操控浏览器
强大的扩展系统
- Skills（技能）：类似插件，教会 AI 如何使用特定工具
- MCP 服务器：连接外部数据源和服务
- ClawdHub：官方技能市场，一键安装社区贡献的技能
二、准备工作
2.1 硬件要求
Clawdbot 对硬件要求非常友好，以下任意设备均可：
技术小白提示：如果你只是想体验，用你日常使用的 Mac 或 Windows 电脑就完全足够！
2.2 软件环境要求
核心要求：Node.js 22 或更高版本
Node.js 是什么？
Node.js 是一个让 JavaScript 代码能在电脑上运行的环境。Clawdbot 是用 JavaScript/TypeScript 编写的，所以需要 Node.js 来运行它。你可以把 Node.js 理解为"Clawdbot 的运行引擎"。
2.3 获取 AI 模型的 API Key
Clawdbot 本身不包含 AI 大脑，它需要连接到 AI 模型服务。最推荐的选择是 Anthropic 的 Claude 模型。
获取 Claude API Key 的三种方式：
官方强烈推荐：Claude Max/Pro 订阅 + Opus 4.5 模型
原因：更长的上下文窗口、更强的抗提示注入能力、可复用订阅额度无需额外购买 API
三、安装 Clawdbot（分系统详解）
3.1
macOS 安装
macOS 是 Clawdbot 支持最好的平台，有专门的 Mac 应用可用。
步骤一：安装 Node.js
打开"终端"（在启动台搜索"终端"或按 Cmd + 空格 搜索 Terminal），输入：
# 检查是否已安装 Node.js node --version如果显示 v22.x.x 或更高版本，跳到步骤二。如果提示"command not found"或版本低于 22，继续安装：
# 使用官方安装脚本（推荐新手） curl -fsSL https://nodejs.org/install.sh | bash或者使用 Homebrew（如果你已安装 Homebrew）：
brew install node@22步骤二：安装 Clawdbot
# 官方一键安装脚本 curl -fsSL https://clawd.bot/install.sh | bash或者使用 npm 手动安装：
npm install -g clawdbot@latest步骤三：运行初始化向导
clawdbot onboard --install-daemon这个命令会做什么？
- 引导你配置 AI 模型（选择 Anthropic、OpenAI 等）
- 输入你的 API Key 或登录凭据
- 安装 Gateway 守护进程（让 Clawdbot 作为后台服务持续运行）
- 配置消息通道（Telegram、Discord 等）
3.2
Windows 安装
重要提示：官方强烈推荐在 WSL2 中运行 Clawdbot
什么是 WSL2？
WSL2（Windows Subsystem for Linux 2）让你可以在 Windows 上运行完整的 Linux 环境。Clawdbot 在 Linux 环境中运行更稳定，所以推荐使用 WSL2。
步骤一：启用 WSL2
以管理员身份打开 PowerShell，运行：
wsl --install 安装完成后重启电脑。重启后会自动打开 Ubuntu 终端，设置用户名和密码。
步骤二：在 WSL2 中安装 Node.js
# 更新系统包 sudo apt update && sudo apt upgrade -y
# 安装 Node.js 22 curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
# 验证安装 node --version # 应显示 v22.x.x 步骤三：安装 Clawdbot
curl -fsSL https://clawd.bot/install.sh | bash
clawdbot onboard --install-daemon3.3
Linux 安装（Ubuntu/Debian）
# 1. 更新系统 sudo apt update && sudo apt upgrade -y
# 2. 安装 Node.js 22 curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
# 3. 安装 Clawdbot curl -fsSL https://clawd.bot/install.sh | bash
# 4. 初始化（安装为 systemd 服务） clawdbot onboard --install-daemon3.4
Docker 安装（高级用户/服务器部署）
# 拉取官方镜像 docker pull clawdbot/clawdbot:latest
# 运行容器 docker run -d \
--name clawdbot \
-p 18789:18789 \
-v ~/.clawdbot:/root/.clawdbot \
clawdbot/clawdbot:latest3.5
从源码安装（开发者）
如果你想参与开发或使用最新特性：
git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot
pnpm install
pnpm ui:build # 首次运行时自动安装 UI 依赖 pnpm build
pnpm clawdbot onboard --install-daemon四、配置详解
4.1 配置 AI 模型（以 Anthropic Claude 为例）
方式一：交互式配置（推荐新手）
clawdbot onboard运行后选择 "Anthropic API key"，按提示输入你的 API Key。
方式二：命令行直接配置
clawdbot onboard --anthropic-api-key "sk-ant-api03-你的密钥" 方式三：配置文件
配置文件位于 ~/.clawdbot/config.json，你可以直接编辑：
{
"agent": {
"model": "anthropic/claude-sonnet-4.5" },
"providers": {
"anthropic": {
"apiKey": "sk-ant-api03-你的密钥" }
}
}推荐模型选择：
| 模型 | 特点 | 适用场景 |
|---|---|---|
claude-opus-4.5 | 最强大，长上下文 | 复杂任务、深度分析 |
claude-sonnet-4.5 | 平衡性能与成本 | 日常使用（推荐） |
claude-haiku-3.5 | 速度快、成本低 | 简单任务、快速响应 |
4.2 配置消息通道
查看当前通道状态：
clawdbot channels status配置 Telegram
- 在 Telegram 中搜索 @BotFather，发送
/newbot - 按提示设置机器人名称，获取 Bot Token
- 运行配置：
clawdbot channels login --provider telegram按提示输入你的 Bot Token。
配置 Discord
- 访问 Discord 开发者门户
- 创建新应用 → 进入 Bot 设置 → 开启必要权限
- 点击 "Reset Token" 获取 Bot Token
- 运行配置：
clawdbot channels login --provider discord配置 WhatsApp
WhatsApp 使用 WhatsApp Web 协议，需要扫码登录：
clawdbot channels login --provider whatsapp终端会显示一个二维码，用 WhatsApp 扫描即可。
重要限制：一台主机只能运行一个 Gateway 进程，因为它独占 WhatsApp Web 会话。
4.3 安全设置：DM 权限控制
从 v2026.1.8 版本开始，Clawdbot 默认锁定私聊功能
这意味着陌生人无法直接私聊你的机器人。你需要手动批准配对请求：
# 查看待批准的配对请求 clawdbot pairing list --provider telegram
# 批准某个请求 clawdbot pairing approve --provider telegram <配对码>如果你希望开放给所有人使用（不推荐）：
在配置文件中设置：
{
"channels": {
"telegram": {
"dmPolicy": "open",
"allowFrom": ["*"]
}
}
}五、访问本地控制台
5.1 启动 Gateway
如果 Gateway 没有自动启动：
clawdbot gateway或者以后台服务启动：
clawdbot gateway start5.2 打开 Web 控制台
Clawdbot 提供了一个本地 Web 仪表板：
在浏览器中访问：
http://localhost:18789 或者：
http://127.0.0.1:18789 控制台功能：
- 查看所有对话历史
- 管理通道连接状态
- 配置技能和插件
- 监控系统资源使用
- 查看日志和调试信息
六、技能（Skills）与扩展
6.1 理解 Clawdbot 的能力系统
Clawdbot 通过"技能"来扩展能力。技能本质上是一组指令和工具的组合：
Clawdbot 架构
├── Agent Loop（推理循环）—— 决定做什么
├── Agent Runtime（执行环境）—— 运行代码和脚本
├── MCP Servers（外部连接）—— 连接外部工具和数据
└── Skills（技能指南）—— 指导如何使用特定工具
6.2 技能的存放位置
技能按如下优先级加载：
6.3 使用 ClawdHub 安装社区技能
ClawdHub 是 Clawdbot 的官方技能市场：
# 搜索技能 clawdbot skills search "web scraping"
# 安装技能 clawdbot skills install web-scraper
# 查看已安装技能 clawdbot skills list6.4 常用内置技能示例
| 技能名称 | 功能 | 示例用法 |
|---|---|---|
web-search | 网络搜索 | "帮我搜索最新的 AI 新闻" |
browser | 浏览器自动化 | "打开 GitHub 并截图" |
terminal | 执行终端命令 | "查看当前目录文件" |
calendar | 日历管理 | "明天下午3点提醒我开会" |
file-manager | 文件操作 | "整理下载文件夹" |
七、日常使用指南
7.1 基本对话
配置完成后，你可以在 Telegram/Discord/WhatsApp 中直接与 Clawdbot 对话：
你：今天天气怎么样？
：让我为你查询...北京今天晴，气温 15-23°C，适合外出！
你：帮我总结一下这个网页 https://example.com ：正在读取网页内容...这篇文章主要讲述了...
你：每天早上 8 点给我发一份新闻摘要
：好的，我已设置每日早报提醒，明天早上 8 点开始推送！7.2 常用命令
在聊天中可以使用特殊命令：
| 命令 | 功能 |
|---|---|
/status | 查看系统状态 |
/memory | 查看当前记忆 |
/forget | 清除某条记忆 |
/skills | 列出可用技能 |
/help | 获取帮助 |
7.3 远程访问（可选）
如果你想从外网访问家里的 Clawdbot：
方式一：SSH 隧道（推荐）
ssh -L 18789:localhost:18789 用户名@你的服务器IP方式二：反向代理（Nginx/Caddy）
配置反向代理并添加身份验证，将 Gateway 暴露到公网。但请注意安全风险！
八、常见问题排查
问题 1：安装后提示"command not found: clawdbot"
解决方案：
# 确保 npm 全局目录在 PATH 中 export PATH="$HOME/.npm-global/bin:$PATH" # 或者重新打开终端 问题 2：Gateway 无法启动
解决方案：
# 检查端口是否被占用 lsof -i :18789
# 查看详细日志 clawdbot gateway --verbose问题 3：提示"No API key found for provider 'anthropic'"
解决方案：
注意！每个 Agent 的认证是独立的。新 Agent 不会继承主 Agent 的密钥。
# 重新运行 onboarding clawdbot onboard
# 或直接设置 clawdbot config set providers.anthropic.apiKey "你的密钥"
# 验证模型状态 clawdbot models status问题 4：WhatsApp 二维码扫描后无反应
解决方案：
- 确保手机和电脑在同一网络
- 尝试重启 Gateway：
clawdbot gateway restart - 清除 WhatsApp 会话：
clawdbot channels logout --provider whatsapp
问题 5：Claude Code OAuth Token 报错
重要更新（2026年1月）：
Anthropic 已更改 Claude Code OAuth tokens 的权限。它们现在仅限于在 Claude Code 内部使用，不能用于外部 API 调用。
解决方案：使用 API Key 或 setup-token 方式认证，而非 OAuth。
九、进阶配置
9.1 使用本地大模型（Ollama）
如果你有高性能显卡，可以使用本地运行的 AI 模型，完全免费且隐私：
# 1. 安装 Ollama curl -fsSL https://ollama.ai/install.sh | sh
# 2. 下载模型（以 llama3.1 为例） ollama pull llama3.1:70b
# 3. 启动 Ollama 服务 ollama serve
# 4. 配置 Clawdbot 使用本地模型 # 编辑 ~/.clawdbot/config.json 配置文件示例：
{
"agent": {
"model": "ollama/llama3.1:70b" },
"providers": {
"ollama": {
"baseUrl": "http://127.0.0.1:11434" }
}
}9.2 多 Agent 配置
Clawdbot 支持创建多个 Agent，用于不同场景：
# 创建工作专用 Agent clawdbot agent create --name "work-assistant"
# 创建生活助手 Agent clawdbot agent create --name "life-helper"
# 切换 Agent clawdbot agent switch work-assistant9.3 编写自定义技能
创建一个简单的技能：
mkdir -p ~/.clawdbot/skills/my-skill创建 ~/.clawdbot/skills/my-skill/SKILL.md：
---
name: my-custom-skill
description: 我的自定义技能
tools:
- terminal
---
# 我的技能
当用户请求 [某种操作] 时，按以下步骤执行：
1. 首先...
2. 然后...
3. 最后...十、最佳实践与建议
安全建议
性能优化
| 建议 | 效果 |
|---|---|
| 使用 SSD 存储 | 提升响应速度 |
| 分配足够内存 | 避免 OOM 崩溃 |
| 合理选择模型 | 平衡成本与性能 |
| 定期清理旧日志 | 释放磁盘空间 |
使用技巧
- 建立"记忆仪式"：定期告诉 Clawdbot 你的偏好和习惯
- 善用主动提醒：让它成为你的私人秘书
- 组合多技能：例如"搜索+总结+发送邮件"一条龙
- 创建工作流模板：把常用任务流程固化为技能
总之，Clawdbot 代表了个人 AI 助手的新范式：
- 本地优先：你的数据永远在你的掌控之中
- 开放生态：社区驱动，持续进化
- 真正智能：不只是问答，更能主动行动
- 高度可定制：从模型到技能，一切随你心意
正如其官方 Slogan 所说："The AI Assistant Siri Promised But Never Delivered"（Siri 承诺过但从未实现的 AI 助手）—— Clawdbot 正在让这个愿景成为现实。
附录
参考资源
| 资源 | 链接 |
|---|---|
 官方网站 | clawd.bot |
 官方文档 | docs.clawd.bot |
 GitHub 仓库 | github.com/clawdbot/clawdbot |
 技能市场 | clawdhub.com |
 中文社区版 | github.com/bbylw/clawdbot-cn |