返回列表
🦐
丸美小沐2025-01-26 · 15m

Clawdbot 云服务器部署教程：从零到上手只需 7 步

Clawdbot 云服务器部署教程：从零到上手只需 7 步

原文来自「夕小瑶科技说」公众号 作者：丸美小沐

Clawdbot 一夜爆火。

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

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

为什么 Clawdbot 火了

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

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

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

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

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

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

为什么推荐部署到云服务器

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

理由很简单：

  1. 安全考虑：它有访问你本地设备的权限，权限非常大，为了保护你本地的文件，还是不要部署在自己的笔记本电脑上。
  2. 稳定性：你的电脑不可能放在那里 24 小时不关机，一旦关机它就停了。云服务器可以 24 小时跑。
  3. 成本对比：我花 30 块租了台 VPS，Mac mini 最便宜 599 美元（约 4300 元），VPS 每月 30 元，用 10 年才 3600 元。而且 VPS 坏了重开一台就行。

我看到好多人搞不定这个，很多人卡在了部署环节。所以这篇文章，我把部署教程放到最前面，手把手带大家从零到能用，保证小白能看懂。

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

给会用 Claude Code 的朋友：如果你觉得手动配置太麻烦，可以使用 Clawdbot 部署助手 Skill，可以智能适配你的配置，自动排查问题。

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

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

需要准备说明
云服务器运行 Clawdbot 的"家"
Telegram 机器人你和 Clawdbot 交互的入口
Claude API KeyClawdbot 的"大脑"

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

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

  1. 打开 https://www.aliyun.com/product/swas（仅做示例，各家云服务器都可以）
  2. 注册登录（手机号即可）
  3. 选择配置：
    • 地域：香港（国内需复杂备案，香港不需要）
    • 镜像：Ubuntu 22.04 LTS
    • 套餐：2 核 2G，30GB SSD（够用了，别选太低）
    • 时长：先买 1 个月
  4. 支付完成，进入控制台，开放端口。
  5. 重置密码，自己设一个好记的。
  6. 记下三个信息：
IP地址：xxxx.xxxx.xxxx
用户名：root
密码：xxxx

这台服务器就是 Clawdbot 的"家"，它会 7×24 小时在这里运行。

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

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

操作步骤：

  1. 打开 Telegram，搜索 @BotFather（有蓝勾认证的官方账号）
  2. 点击 START，发送命令：
/newbot
  1. BotFather 会让你给机器人起个名字，随便敲个名字"qq 机器人"即可（可以用中文，类似昵称）。
  2. 然后再取一个用户名，例如 MadscBot（必须英文，必须以 bot 结尾）。用户名类似 QQ 号，不能重复。
  3. 成功后，BotFather 会发给你一个 token。
  4. 复制 token，保存好。这个 token 很关键，因为要把它给到 Clawdbot，Clawdbot 才能连接上这个 bot。
  5. 点击 t.me/你的bot用户名 提前添加机器人好友备用。

第三步：获取 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（重点！）

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

1. 编辑配置文件

nano /root/.clawdbot/clawdbot.json

2. 删除所有内容

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

3. 修改配置

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

如果你用的是第三方 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

4. 保存退出

  • 按 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 分钟）

  1. 打开 Telegram，找到你的机器人
  2. 发送任意消息，比如 你好
  3. 机器人回复配对码
  4. 复制配对码
  5. 回到服务器 SSH 窗口，执行：
clawdbot pairing approve telegram ABC123

（把 ABC123 换成你的配对码）

  1. 回到 Telegram，再发一条 hi
  2. 如果机器人回复了，恭喜部署成功！

最容易踩的坑

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

坑 1：第三方 API 配置姿势

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

错误示例正确示例
"api": "anthropic""api": "anthropic-messages"
"baseUrl": "https://xxx.xx/v1""baseUrl": "https://xxx.xx"

注意：api 必须写 anthropic-messages，baseUrl 不要带 /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 错误，原因通常是：

  1. Linger 没启用 - SSH 断开后服务被杀死
  2. 会话缓存损坏 - 旧的 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，群里不少朋友说效果也够用的。

Tags

TutorialDeploymentTelegramGetting Started

相关阅读

从0到1玩转 ClawdBot：40小时深度研究总结

从0到1玩转 ClawdBot：40小时深度研究总结

2025-01-2520m
OpenClaw 实战 72 小时：那些文档不会告诉你的坑

OpenClaw 实战 72 小时：那些文档不会告诉你的坑

2026-02-015m
ClawdBot 架构解析：它到底是如何工作的

ClawdBot 架构解析：它到底是如何工作的

2026-01-3010m