Clawdbot 通用部署与配置指南
本文介绍如何在 Ubuntu 服务器上部署 Clawdbot Gateway，接入 GitHub Copilot 模型并连接 Telegram 机器人。在开始之前，请确保你已准备好以下基础资源。
前置准备
- LLM API Key：本文使用 GitHub Copilot（可通过学生认证免费获取 Pro），也可替换为月之暗面等其他提供商的 Key。
- 机器人服务：推荐使用 Telegram Bot，同样支持 WhatsApp 等。
- 服务器环境：Linux 系统即可，本文基于 Ubuntu 22.04，配置建议 2H2G。
注意：Clawdbot 权限较高，建议使用非 root 业务用户运行，避免潜在的安全风险。
安装基础工具
首先更新软件源并安装必要的依赖包：
sudo apt update && sudo apt -y install curl ca-certificates git lsof
配置 Node.js 环境
我们使用 nvm 来管理 Node 版本，这样更灵活。
1. 安装 nvm
curl -fsSL https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
安装完成后，重新加载当前 shell 使配置生效：
exec bash
验证 nvm 是否可用：
command -v nvm && nvm --version
如果输出了路径或版本号，说明安装成功。
2. 安装 Node.js
虽然很多教程推荐 Node 22，但根据社区近期反馈，Node 22 在配置 Telegram 机器人时可能会遇到启动 bug。因此，建议直接安装最新的 Node 25：
nvm install 25
nvm use 25
nvm alias default 25
验证安装结果：
node -v && npm -v && which node
安装 Clawdbot
通过 npm 全局安装 Clawdbot 命令行工具：
sudo npm i -g clawdbot
安装后验证版本和帮助信息：
clawdbot -v
clawdbot help
初始化本地配置与工作区：
clawdbot setup
运行引导配置
执行 onboard 命令进入交互式配置向导：
clawdbot onboard
配置过程中会依次询问以下内容：
- 模型选择：选择 Copilot。稍后浏览器会弹出授权页面，输入代码登录 GitHub 账号完成授权。
