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