前置准备
- 一台运行 Linux 系统的服务器（建议 Ubuntu 22.04+），配置 2H2G。
- 一个非 root 的业务用户（clawd 权限较高，建议使用普通用户）。
- 一个可用的 LLM 服务 API Key（本文使用 GitHub Copilot，也可替换为其他提供商如月之暗面）。
- 一个可用的机器人服务 Token（本文使用 Telegram，也可使用 WhatsApp 等）。
- 已开通 GitHub Copilot 订阅或组织授权。
安装基础工具
sudo apt update && sudo apt -y install curl ca-certificates git lsof
安装 Node.js
安装 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
用 nvm 安装 Node.js（推荐版本 25）：
nvm install 25
nvm use 25
nvm alias default 25
注意：Node.js 22 版本在配置 Telegram 机器人时可能存在 Bug，建议直接使用 Node.js 25。
验证安装是否完成：
node -v && npm -v && which node
安装 Clawdbot
使用 npm 全局安装：
sudo npm i -g clawdbot
验证安装：
clawdbot -V
clawdbot help
初始化本地配置与工作区：
clawdbot setup
运行引导配置
clawdbot onboard
按提示选择配置：
- 模型选择 Copilot。稍后弹出网址和八位代码，登录 GitHub 账号输入代码授权。
- 机器人代理选择 Telegram。需先在 BotFather 注册机器人并获取 Token。
- Skills 和其他功能根据需要选择 Yes 或 No。
启动 Gateway
建议先用最小启动命令确认能监听端口：
clawdbot gateway --bind loopback --port 18789
检查监听状态：
sudo lsof -i TCP:18789 -s TCP:LISTEN -n -P
