怎么用上一夜爆火的Clawdbot，详细配置教程

阅读预计 8 分钟

本文转载自怎么用上一夜爆火的Clawdbot，详细配置教程

Clawdbot 一夜爆火。

昨天这个 Clawdbot 在多个平台上疯狂的刷屏，作为一个开源项目，一天内 GitHub 的 stars 就激增了 9000 多，一夜之间新增了 200 多个 PR，创始人自己都说这个项目炸了，都疯了。

简单说，Clawdbot 是一个个人 AI 助手，完全本地化、7*24 小时不停歇干活的 Claude。

为什么它就火了呢？

不是因为 7*24 小时，不是因为它可以访问文件、浏览器、邮件，而是因为这个东西支持你在通讯 APP 上和它交互。

比如，你在打着游戏，在 iMessage 里给他安排一个任务，它就去干了，干完回来还通知你 done。整个过程就像在微信里给朋友发了一条消息一样。

支持几乎所有主流通讯平台：WhatsApp、Telegram、Slack、Discord 、Google Chat、Signal、iMessage 、Microsoft Teams、Matrix、Zalo、WebChat。

第二个点：它可以运行在你自己的设备上，Mac、PC、树莓派、云服务器上。

这个点出现的也很及时，现在的 AI bot 基本上还寄生在浏览器里，当然桌面端也有，比如前段时间 Minimax 也推出了桌面端 APP，可以自己操控浏览器干活，Claude Cowork 能访问本地文件夹操作文件。

但 Clawdbot 是可以部署在任何终端设备了，电脑、手表、树莓派甚至智能眼镜里，比如这想象空间一下子就打开了。

但是，前提是，你部署的设备都得是一直开着机、在线。

它就是一个服务器应用，Clawdbot 架构中最核心的是 Gateway（网关），Gateway 整个系统的大脑，是唯一的中心节点，所有消息都通过它路由。如果它离线，整个系统瘫痪。

因为一直在线，所以它就可以主动联系你，主动发送天气、日程、新闻，任务进度，成了一个主动式助手（Proactive AI），区别于被动的聊天机器人。如果只需要被动回答，可以用 ChatGPT。

Clawdbot 爆火还引发了 Mac mini 的哄抢潮，但是完全没必要，因为我觉得部署在云端服务器是最方便的，我也最推荐。

因为它有访问你本地设备的权限，虽然我还没有搞懂这个权限怎么获取的，但是这个权限非常大，为了保护你本地的文件，还是不要部署在自己的笔记本电脑上。

而且你的电脑不可能放在那里 24 小时不关机，一旦关机它就停了。所以选一台云服务器是最好的，可以 24 小时跑。

我花 30 块租了台 VPS，Mac mini 最便宜 599 美元（约 4300 元），VPS 每月 30 元，用 10 年才 3600 元。而且 VPS 坏了重开一台就行。

我看到好多人搞不定这个，很多人卡在了部署环节。

所以这篇文章，我把部署教程放到最前面，手把手带大家从零到能用，保证小白能看懂。

直接开始部署，从零到能用只需 7 步

给会用 Claude Code 的朋友：

如果你觉得手动配置太麻烦，文末我准备了Clawdbot 部署助手 Skill，可以智能适配你的配置，自动排查问题。

不过我还是建议先看一遍教程，了解部署原理。遇到问题才知道怎么排查。

手动部署法：你需要三样东西

📌 第一步：买云服务器（10 分钟）

例如：阿里云/腾讯云/华为云/不知名小云服务器，新手友好。

打开 https://www.aliyun.com/product/swas（仅做示例，各家云服务器都可以）
注册登录（手机号即可）
选择配置：

地域：香港（国内需复杂备案，香港不需要）
镜像：Ubuntu 22.04 LTS
套餐：2 核 2G，30GB SSD（够用了，别选太低）
时长：先买 1 个月

支付完成，进入控制台，开放端口。

重置密码，自己设一个好记的。

记下三个信息：

IP地址：xxxx.xxxx.xxxx  
用户名：root  
密码：xxxx

这台服务器就是小龙虾的“家”，它会 7×24 小时在这里运行。

📌 第二步：创建 Telegram 机器人（5 分钟）

在手机上就能完成，不需要服务器。这是你和 Clawdbot 交互的入口。

操作步骤：

1. 打开 Telegram，搜索 @BotFather（有蓝勾认证的官方账号）

2. 点击 START，发送命令：

/newbot

这一步是创建一个机器人，BotFather 会让你给机器人起个名字，随便敲个名字“qq 机器人”即可。（可以用中文，类似昵称）

然后再取一个用户名，我的叫 MadscBot（必须英文，必须以 bot 结尾）。用户名类似 QQ 号，不能重复。

3. 成功后，BotFather 会发给你一个 token。

4. 复制token，保存好。这个 token 很关键，因为要把它给到Clawdbot，Clawdbot 才能连接上这个 bot。

5. 点击 t.me/McdscBot 提前添加机器人好友备用。

📌 第三步：获取 Claude API Key（5 分钟）

有两个选择，推荐国内用户用第三方 API。

方案 A：支持 Claude 模型的三方中转 API

手机号注册，支付宝/微信充值
充值 50 元能用很久
创建 API Key，复制保存
格式：sk-xxxxxxxxxxxxxxxx

方案 B：官方 Anthropic API

访问 https://console.anthropic.com
需要国外手机号
按量付费，约 $15/百万 tokens

记下你的 API Key，下一步要用。

（此处省略了一万字）

📌 第四步：登录服务器（3 分钟）

登陆第一步购买的云服务器。

Windows 用户：

1. 按 Win+R，输入 cmd，回车  
2. 输入：ssh root@你的服务器IP  
3. 输入密码（不会显示，直接粘贴回车）  
4. 看到 root@xxxxx:~# 就连上了

Mac/Linux 用户：

1. 打开终端  
2. 输入：ssh root@你的服务器IP  
3. 输入密码

📌 第五步：安装 Clawdbot（10 分钟）

连上服务器后，复制粘贴执行以下命令：

_# 1. 更新__apt_  
apt update && apt upgrade -y

_# 2. 一键安装Clawdbot_  
curl -fsSL https://clawd.bot/install.sh | bash  
_# 3. 等待安装完成，看到 "Installation complete!" 就成功了_

如果报错，重新执行第 2 步。

📌 第六步：配置 Clawdbot（重点！）

这是最容易出错的一步，跟着我一字不差地操作。

编辑配置文件

nano /root/.clawdbot/clawdbot.json

删除所有内容

按 Ctrl+K 逐行删除原有内容，直到文件完全空白。

修改配置

先原封不动地把下面这段代码复制过来。

如果你用的是第三方 API，复制这段：

{"models": {"providers": {"xxx": {"baseUrl": "https://xxx.xx","apiKey": "在这里粘贴你的API Key","api": "anthropic-messages","models": [{"id": "claude-opus-4-5-20251101","name": "Claude Opus 4.5","reasoning": true,"input": ["text", "image"],"contextWindow": 200000,"maxTokens": 4096}]}}},"channels": {"telegram": {"enabled": true,"botToken": "在这里粘贴你的Bot Token","profiles": ["default"]}},"agents": {"defaults": {"model": {"primary": "xxxx/claude-opus-4-5-20251101"}}}}

如果你用的是官方 Anthropic API，复制这段：

{"models": {"providers": {"anthropic": {"apiKey": "在这里粘贴你的Anthropic API Key"}}},"channels": {"telegram": {"enabled": true,"botToken": "在这里粘贴你的Bot Token","profiles": ["default"]}},"agents": {"defaults": {"model": {"primary": "anthropic/claude-opus-4-5-20251101"}}}}

然后修改三个地方（重要！）。

把 "apiKey": "在这里粘贴你的API Key" 的引号里内容换成你的 API Key
把 "https//xxx.xx": "在这里粘贴你自己的" 的引号里内容换成你的中转站 Base URL
把 "botToken": "在这里粘贴你的Bot Token" 的引号里内容换成你的 Bot Token（就是第二步里 telegram 的 bot token）

保存退出

按 Ctrl+O 保存（会提示文件名，直接回车）
按 Ctrl+X 退出

📌 第七步：启动服务（5 分钟）

_# 1. 启用持久化（让服务一直运行）_  
loginctl enable-linger root

_# 2. 设置环境变量_export XDG_RUNTIME_DIR=/run/user/0

_# 3. 启动服务_  
systemctl --user start clawdbot-gateway.service

_# 4. 检查状态_  
systemctl --user status clawdbot-gateway.service

看到 Active: active (running) 就成功了！

如果看到红色错误，执行这个查看日志：

journalctl --user -u clawdbot-gateway.service -n 30 --no-pager

📌 第八步：配对你的 Telegram 账号（3 分钟）

打开 Telegram，找到你的机器人（搜索 @McdscBot）
发送任意消息，比如 你好
机器人回复：

复制配对码
回到服务器 SSH 窗口，执行：

clawdbot pairing approve telegram ABC123

（把 ABC123 换成你的配对码）
回到 Telegram，再发一条 hi
如果机器人回复了，恭喜部署成功！🎉

三、最容易踩的坑

我在部署时踩了三个大坑，分享给大家避免。很多人就是卡在这些地方放弃的。

❌ 坑 1：第三方 API 配置姿势

第三方 Claude API 的配置有两个隐藏规则，官方文档没明说，我试了一晚上才发现：

错误示例：

"api": "anthropic",           ❌ 错！很多人写成这个  
"baseUrl": "https://xxx.xx/v1"  ❌ 错！多了/v1

正确示例：

"api": "anthropic-messages",  ✅ 对！必须这样写  
"baseUrl": "https://xxx.xx"     ✅ 对！不要带/v1

❌ 坑 2：改完配置必须清缓存

这个坑让我卡了半小时。每次修改配置文件后，必须清理缓存并重启，否则新配置不生效：

_# 清理缓存_rm -rf /root/.clawdbot/agents/main/agent/sessions/*

_# 重启服务_export XDG_RUNTIME_DIR=/run/user/0  
systemctl --user restart clawdbot-gateway.service

症状：明明改了配置，但日志里还是显示旧的模型/API。你怀疑配置没生效，反复改，越改越乱。

原因：Clawdbot 会缓存会话状态，包括模型配置、API 连接等。不清缓存，它继续用旧的。

❌ 坑 3：服务不断重启（最难排查）

如果你发现服务每隔 10-15 秒就自动重启一次，日志里有 fetch failed 或 ERR_SERVER_CLOSED 错误，原因通常是：

Linger 没启用 – SSH 断开后服务被杀死
会话缓存损坏 – 旧的 session 文件导致启动失败

完整解决方案：

_# 1. 启用linger（让服务持续运行）_  
loginctl enable-linger root  
loginctl show-user root | grep Linger  _# 确认显示 Linger=yes# 2. 清理会话缓存_rm -rf /root/.clawdbot/agents/main/agent/sessions/*

_# 3. 重启服务_export XDG_RUNTIME_DIR=/run/user/0  
systemctl --user restart clawdbot-gateway.service

_# 4. 监控日志，确认不再重启_  
journalctl --user -u clawdbot-gateway.service -f

为什么 Linger 这么重要？

因为 Clawdbot 使用“用户级 systemd ”服务，默认情况下用户登出（SSH 断开）后服务会停止。启用 Linger 后，服务变成“持久化”，即使你关掉终端也继续运行。

记住这些，能少走很多弯路。

四、实测效果：它到底能干啥？（让你看完教程有动力）

部署完成后，我在 Telegram 里让它装了我的选题 skill。

接着，对 Bot 说了一句“抓一下今天的选题”。3 秒钟后，它给我吐出来一个完整的选题表，包含今日 AI 科技热点 TOP 5，每条新闻都标注了价值评分和适合的文章类型，分得清清楚楚。

跟 Claude Code 的体验一模一样，只不过是在 Telegram 里完成的。我还测试了文档整理，让它把 10 篇论文摘要整理成表格，它会自动解析文档提取关键信息生成结构化表格。

甚至可以让它写个 Python 脚本，每天早上 8 点抓取 Hacker News 前 10 条发给我。如果你用的是 Mac，它还能控制浏览器自动登录网站、填写表单、批量下载文件…

总之，Claude Code 能干的事它基本都能干，区别只是你在手机上发消息它在服务器上执行。

虽然我用的是第三方的 Claude API，但是依旧贵。

比如我发了一句“发给我”。

后台监测显示输入 token 有 2 万多。。。估计是把上面所有的上下文都打包进去了，猜测这级别的项目肯定有压缩机制，但是还是建议新开 session 节省 token。

大家实操起来可以替换成国产 MiniMax M2.1 GLM4.7，看群里不少朋友说效果也够用的。

彩蛋：Clawdbot 部署助手 Skill

我把这整个部署流程做成了一个 Skill，可以智能适配不同用户的配置，它会：

询问你的服务器信息、API 提供商、Bot Token
自动生成对应的配置文件
引导你完成每一步
自动排查常见问题

在公众号主页回复【Clawdbot】，获取 Clawdbot 的一键部署 Skills 链接。