主权个人必看的 Clawdbot 本地部署完全指南（2026版）

人工智能研究

主权个人必看的 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 助手的本质区别

对比维度	传统 AI 助手（Siri/小爱）	Clawdbot
🏠 运行位置	云端服务器	你自己的设备
🔐 数据归属	存储在公司服务器	完全存储在本地
💬 交互方式	专用 App 或语音	微信、Telegram、Discord 等你已有的聊天软件
🧠 AI 模型	厂商指定	自由选择（Claude、GPT、本地模型等）
🔧 可扩展性	几乎不可定制	开源，完全可定制
⏰ 主动性	被动响应	可主动提醒、汇报、预警
💰 费用	订阅制	复用现有 AI 订阅或 API

1.3 Clawdbot 能做什么？

Clawdbot 不仅仅是一个聊天机器人，它是一个真正的"数字员工"：

🗣️ 多平台消息响应

支持 WhatsApp、Telegram、Discord、Slack、Signal、iMessage、微信（通过第三方桥接）等 50+ 平台
你在任何聊天软件里 @它或私聊它，它都能响应

🧠 持久记忆系统

记忆以 Markdown 文件形式存储在本地，类似 Obsidian 知识库
它能记住你的偏好、过往对话、重要信息
不会像普通 AI 那样"失忆"

⚡ 主动行动能力

定时提醒、日程汇报、新闻摘要
监控任务并主动通知你结果
可以执行终端命令、编写并运行脚本、操控浏览器

🔌 强大的扩展系统

Skills（技能）：类似插件，教会 AI 如何使用特定工具
MCP 服务器：连接外部数据源和服务
ClawdHub：官方技能市场，一键安装社区贡献的技能

二、准备工作

2.1 硬件要求

Clawdbot 对硬件要求非常友好，以下任意设备均可：

设备类型	最低配置	推荐配置
💻 个人电脑	4GB 内存	8GB+ 内存
🖥️ Mac	macOS 11+ (Intel/Apple Silicon)	M1/M2/M3/M4 芯片
🐧 Linux 服务器	Ubuntu 20.04+	Ubuntu 22.04/24.04
🥧 树莓派	Raspberry Pi 4 (4GB)	Raspberry Pi 5 (8GB)
🐳 Docker 环境	2 核心 2GB 内存	4 核心 4GB 内存
☁️ 云服务器	1 vCPU 2GB	2 vCPU 4GB

💡 技术小白提示：如果你只是想体验，用你日常使用的 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 订阅	已有订阅用户	$100-200/月	⭐⭐⭐⭐⭐
Anthropic API	按量付费用户	按使用量计费	⭐⭐⭐⭐
本地模型（Ollama）	高级用户/隐私敏感	免费（需显卡）	⭐⭐⭐

💡 官方强烈推荐：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-daemon

3.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-daemon

3.4 🐳 Docker 安装（高级用户/服务器部署）

# 拉取官方镜像 docker pull clawdbot/clawdbot:latest

# 运行容器 docker run -d \
  --name clawdbot \
  -p 18789:18789 \
  -v ~/.clawdbot:/root/.clawdbot \
  clawdbot/clawdbot:latest

3.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 start

5.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 技能的存放位置

技能按如下优先级加载：

优先级	位置	说明
🥇 最高	`<workspace>/skills/`	当前工作区技能
🥈 中等	`~/.clawdbot/skills/`	用户全局技能
🥉 最低	内置技能	系统自带技能

6.3 使用 ClawdHub 安装社区技能

ClawdHub 是 Clawdbot 的官方技能市场：

# 搜索技能 clawdbot skills search "web scraping" 
# 安装技能 clawdbot skills install web-scraper

# 查看已安装技能 clawdbot skills list

6.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-assistant

9.3 编写自定义技能

创建一个简单的技能：

mkdir -p ~/.clawdbot/skills/my-skill

创建 ~/.clawdbot/skills/my-skill/SKILL.md：

---
name: my-custom-skill
description: 我的自定义技能
tools:
  - terminal
--- 
# 我的技能 
当用户请求 [某种操作] 时，按以下步骤执行：
1. 首先...
2. 然后...
3. 最后...

十、最佳实践与建议

✅ 安全建议

建议	原因
🔒 保持 Gateway 仅绑定 localhost	避免未授权访问
🔑 定期轮换 API Key	降低密钥泄露风险
👥 使用 DM 配对机制	防止陌生人滥用
💾 定期备份 `~/.clawdbot` 目录	保护记忆和配置

✅ 性能优化

建议	效果
使用 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

Brave 回复 5 days, 11 hours ago 1 成員 · 0 回复

0 回复

歡迎留言回复交流。

登入後即可回复

人工智能研究

組織者: