ClawdBot

概述

ClawdBot 是一个本地运行的 AI 助手网关。它的核心是一个 Gateway 进程，负责：

• 连接各种聊天平台（Telegram、WhatsApp、Discord、iMessage 等）
• 调用 AI 模型（Claude、GPT、本地模型都行）
• 执行系统命令、读写文件、控制浏览器
• 管理定时任务和自动化流程

你可以把它理解成一个 7x24 小时在线的 AI 员工。它有记忆（知道你之前聊过什么），有手脚（能操作你的电脑），还会主动干活（定时任务、邮件监控）。

它能干什么

• 随时随地发消息：手机上给 Bot 发消息，秒回。出门在外也能远程操作服务器
• 查服务器状态：让它跑个 htop 或者看 Docker 容器，截图发过来
• 定时任务：每天早上 7 点发一份服务器健康报告
• 写代码调试：把报错信息发给它，它能直接帮你改文件 https://cloudstudio.net/t/10108

clawdbot启动

clawdbot gateway --port 18789

1.启动终端，输入以上命令。

2.启动成功后，打开端口管理插件，找到18789端口，点击查看预览会显示如下信息：

3.初次启动时，需要进行一些基本配置，比如输入token匹配验证，运行clawdbot dashboard,复制toekn。

4.打开gateway服务，找到Overview标签页,粘贴之前复制的token进行验证。

5.如遇到disconnected (1008): pairing required报错，运行clawdbot devices list 查看是否有未匹配请求，如有输入clawdbot devices approve [id]批准即可。

---

配置文件

• 输入以下命令初始化属于自己的clawdbot服务。

clawdbot onboard #初始化

选择-> yes,然后根据提示步骤进行配置。

日常维护

几个常用命令：

# 健康检查
clawdbot doctor

# 全面状态
clawdbot status --all

# 查看配对状态
clawdbot pairing list telegram

# 查看设备列表
clawdbot devices list

注意：在 CloudStudio 环境中，clawdbot 通常以前台进程方式运行。如需重启服务，请：

1. 在运行 clawdbot gateway 的终端按 Ctrl+C 停止服务
2. 重新执行 clawdbot gateway --port 18789 启动服务

更多使用技巧可以访问

云上Moltbot（原Clawdbot）最全实践指南合辑 

进阶：命令白名单

如果想让某些命令自动执行，不用每次批准：

# 允许 docker 命令
clawdbot approvals allowlist add --agent "*" "docker *"

# 允许 systemctl
clawdbot approvals allowlist add --agent "*" "systemctl *"

# 允许 /usr/bin 下的程序
clawdbot approvals allowlist add --agent "*" "/usr/bin/*"

# 查看当前白名单
clawdbot approvals allowlist list

进阶：定时任务

ClawdBot 内置 Cron 功能。比如每天早上 7 点发送服务器状态：

clawdbot cron add --schedule "0 7 * * *" \
  --timezone "Asia/Shanghai" \
  --message "检查服务器状态，给我发个简报" \
  --deliver telegram \
  --to "你的TG用户ID"

或者写进配置文件：

{
  "cron": {
    "jobs": [
      {
        "id": "daily-report",
        "schedule": {
          "cron": "0 7 * * *",
          "timezone": "Asia/Shanghai"
        },
        "sessionTarget": "isolated",
        "payload": {
          "agentTurn": {
            "message": "检查服务器状态，生成简报"
          }
        },
        "deliver": {
          "channel": "telegram",
          "to": "你的TG用户ID"
        }
      }
    ]
  }
}

常见问题

clawdbot: command not found

npm PATH 问题。确认全局目录在 PATH 里：

npm config get prefix
echo 'export PATH=$(npm config get prefix)/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

端口被占用

默认端口 18789 冲突了：

lsof -i :18789  # 看谁在用
clawdbot gateway --port 18790 --verbose  # 换个端口

Bot 收到消息但不回复

按顺序检查：

1. Gateway 在不在跑：clawdbot status
2. 配对了没：clawdbot pairing list telegram
3. API 还有没有额度
4. 检查终端运行状态（在运行 clawdbot gateway 的终端查看输出）

all models failed

API 配置问题：

1. Key 对不对
2. baseUrl 格式对不对（结尾有没有 /v1）
3. model id 写对没
4. 跑一下 clawdbot doctor

工具调用失败

你的 API 不支持 function calling。这种情况 Bot 能聊天，但执行命令用不了。换一个支持工具调用的 API。

CloudStudio Web UI 设备配对流程

在 CloudStudio Web UI 中配对设备的完整流程如下：

1. 查看待批准的配对请求

使用以下命令查看待批准的配对请求：

clawdbot devices list

输出示例：

Pending (3)
┌──────────────────────────────────────┬──────────┬────────┬────────────────┬─────────┐
│ Request                              │ Device   │ Role   │ IP             │ Age     │
├──────────────────────────────────────┼──────────┼────────┼────────────────┼─────────┤
│ f05a949c-3092-4260-888b-c51834d0f06f │ operator │ 222.79.117.163 │ 1m ago │        │
│ d70d3aa5-b95d-45f9-a57c-b4b3cc612c14 │ operator │ 113.219.203.144 │ 1m ago │        │
│ 051f11d8-ee3d-43f2-b34a-b48efb882c06 │ operator │ 222.79.117.163 │ 3m ago │        │
└──────────────────────────────────────┴──────────┴────────┴────────────────┴─────────┘

2. 批准配对请求

批准某个配对请求：

clawdbot devices approve <requestId>

示例：

clawdbot devices approve f05a949c-3092-4260-888b-c51834d0f06f

3. 拒绝配对请求（可选）

如需拒绝某个配对请求：

clawdbot devices reject <requestId>

4. 查看已配对设备

再次运行以下命令查看所有已配对的设备：

clawdbot devices list

输出中的 Paired 部分会显示所有已批准的设备及其角色和权限。

完整配置示例

一个功能完整的配置，开箱即用：

{
  "gateway": {
    "mode": "local",
    "bind": "loopback",
    "port": 18789
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "openai-compat/claude-sonnet-4-5-20261022",
        "fallback": ["openai-compat/claude-haiku-3-5-20241022"]
      },
      "elevatedDefault": "full",
      "thinking": "medium"
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "openai-compat": {
        "baseUrl": "https://你的API地址/v1",
        "apiKey": "你的密钥",
        "api": "openai-completions",
        "models": [
          {
            "id": "claude-sonnet-4-5-20261022",
            "name": "Claude Sonnet 4.5"
          },
          {
            "id": "claude-haiku-3-5-20241022",
            "name": "Claude Haiku 3.5"
          }
        ]
      }
    }
  },
  "tools": {
    "exec": {
      "backgroundMs": 10000,
      "timeoutSec": 1800,
      "cleanupMs": 1800000,
      "notifyOnExit": true
    },
    "elevated": {
      "enabled": true,
      "allowFrom": {
        "telegram": ["你的TG用户ID"]
      }
    },
    "allow": ["exec", "process", "read", "write", "edit", "web_search", "web_fetch", "cron"]
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "你的Bot Token",
      "dmPolicy": "pairing",
      "allowFrom": ["你的TG用户ID"],
      "groupPolicy": "disabled"
    }
  },
  "cron": {
    "jobs": []
  }
}

配置亮点：

• fallback：主模型挂了自动切备用
• thinking: medium：启用中等深度思考
• groupPolicy: disabled：只响应私聊，不进群
• 双重白名单：elevated 和 channels 都设了 allowFrom