ClawdBot 部署指南与功能解析
一、ClawdBot 核心定义
ClawdBot 本质是一款可本地部署的 AI 助手网关工具,核心依托 Gateway 进程实现多维度功能串联,堪称一款 7x24 小时不间断运行的智能化虚拟助手。其核心能力涵盖四大模块:
- 跨平台通信对接:兼容 Telegram、WhatsApp、Discord、iMessage 等主流即时通讯工具;
- 多模型调用适配:支持 Claude、GPT 等在线模型,同时兼容各类本地部署的 AI 模型;
ClawdBot 是一款可本地部署的 AI 助手网关工具,支持跨平台通信对接、多模型调用及系统级操作。部署推荐使用 Node.js 22+ 环境,可通过一键脚本或 npm 手动安装。配置需准备 Telegram Bot Token 及 AI API Key(如 Anthropic)。主要应用场景包括远程服务器监控、自动化任务调度、邮件运维及智能家居联动等,适合希望实现 7x24 小时自动化运维的用户。
ClawdBot 本质是一款可本地部署的 AI 助手网关工具,核心依托 Gateway 进程实现多维度功能串联,堪称一款 7x24 小时不间断运行的智能化虚拟助手。其核心能力涵盖四大模块:
与普通 AI 工具相比,ClawdBot 具备上下文记忆能力、硬件操控权限及主动执行属性。据 Mashable 报道,该工具的火爆曾间接导致 Mac mini 断货,不少用户专门采购小型主机用于本地部署,但从性价比角度,一台月费几十元的云服务器即可满足需求,且无需担心本地设备故障风险。
完成基础部署后,可实现以下实用功能,大幅提升运维效率:
进阶玩法需搭配额外 Skills 及第三方集成,社区常见场景包括:
本文聚焦基础部署流程,完成后可实现聊天交互与基础命令执行功能,进阶玩法可后续按需拓展。
| 所需项目 | 具体说明 |
|---|---|
| 运行设备 | 云服务器(推荐 Ubuntu 24.04)、Mac mini、闲置电脑、树莓派均可,优先选择境外节点规避网络限制 |
| 通讯账号 | Telegram 账号(用于创建专属 Bot) |
| AI 接口 | Claude/GPT 官方 API 或兼容格式的中转 API,后续将详细说明配置要点 |
不同设备各有优劣,结合使用场景推荐如下:
建议新手先通过 VPS 熟悉部署流程,待操作熟练后再考虑采购专用设备。若使用 Mac mini,务必避免用日常工作设备部署,防止配置失误或密钥泄露导致数据风险。
ClawdBot 提供多种安装方式,按推荐优先级排序如下,本文重点演示手动安装流程,帮助理解底层逻辑,便于故障排查。
一键部署脚本(推荐):官方提供的自动化命令,可自动处理依赖安装、权限配置等问题,适合快速部署。
# Linux / macOS 系统执行
curl -fsSL https://get.clawd.bot | bash
clawdbot onboard --install-daemon
该脚本会自动检测系统环境、安装 Node.js 22+ 版本、配置 npm 权限,并全局部署 ClawdBot。
手动 npm 安装:适用于已安装 Node.js 22+ 的环境,执行命令 npm install -g clawdbot@latest 即可完成安装。
ClawdBot 对 Node.js 版本有严格要求,需手动安装指定版本,避免使用系统自带的旧版本。
# 添加 NodeSource 仓库
curl -fsSL https://deb.nodesource.com/setup_22.x | bash
# 执行安装命令
apt-get install -y nodejs
# 验证版本是否达标
node -v
若输出结果为 v22.x.x 则说明安装成功。
注意事项:切勿直接执行 apt install nodejs 命令,系统默认安装版本通常为 v12 或 v18,会引发兼容性错误。
npm install -g clawdbot@latest
# 安装完成后验证版本
clawdbot --version
权限问题解决:若出现 EACCES 权限报错,需配置 npm 全局目录权限:
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
API 配置是部署关键环节,支持官方 API 与中转 API 两种方式,需满足对应要求:
实操参考:可采用 CLI Proxy API 开源项目搭建中转通道,本文选用 gemini-3-flash 模型,运行稳定性较好。
先创建配置目录,再编写 JSON 配置文件,根据 API 类型选择对应模板:
# 创建配置目录
mkdir -p ~/.clawdbot
# 编辑配置文件
nano ~/.clawdbot/clawdbot.json
模板 A:Anthropic 官方 API 配置
{
"gateway": {
"mode": "local",
"bind": "loopback",
"port": 18789
},
"env": {
"ANTHROPIC_API_KEY": "sk-your-key-here"
}
}

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online
JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online
Terser 压缩、变量名混淆,或 javascript-obfuscator 高强度混淆(体积会增大)。 在线工具,JavaScript 压缩与混淆在线工具,online