服务器部署实战
从全新 Ubuntu 服务器开始，接入 Telegram 和 AIGoCode 中转模型，全程 6 步跑通。每步都截了图，容易踩坑的地方已标出。
模型中转推荐：AIGoCode 按用量付费，支持 Claude Opus 4.6 等全部主流模型，国内访问稳定。新用户注册后可领取赠金，覆盖完整的前期探索成本。
准备工作
- 一台全新的 Ubuntu/Debian 服务器（推荐 Ubuntu 22.04+）
- 服务器已安装 Git
sudo apt update && sudo apt install -y git
- 服务器已安装 Node.js v22+
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo bash -
sudo apt-get install -y nodejs
- 一个 aigocode.com 账号，拿到 API Key（sk-xxx 格式）
- 一个 Telegram 账号
第一步：安装 OpenClaw
在服务器终端执行一行命令，全局安装 OpenClaw：
sudo npm install -g openclaw
看到安装成功的提示后，核心程序就位了。
第二步：申请 Telegram 机器人
在 Telegram 里搜索 @BotFather（认准蓝色官方认证标记），按以下步骤操作：
-
发送
/newbot
-
按提示给机器人起一个昵称（支持中文，后续可改）
-
设置一个唯一的用户名（必须以
bot结尾，例如my_ai_bot）
-
创建成功后，BotFather 会返回一串 Bot Token（类似
123456789:ABCdefGHIJ...），复制保存好
安全提醒：Bot Token 相当于机器人的最高控制权密码，不要泄露到公开场合。如果泄露了，可以在 BotFather 里发送
/revoke重新生成。
第三步：运行向导，完成基础配置
在终端输入以下命令启动交互式向导：
openclaw onboard
向导会一步步问你问题，按以下策略选择：
-
I understand this is powerful and inherently risky. Continue? → 选
Yes
-
Onboarding mode → 选
QuickStart（新服务器直接用默认配置，最省事）
-
Model/auth provider → 翻到最底部，选
Skip for now (configure later)。这是关键一步，因为我们要接入的 AIGoCode 不在官方列表里，先跳过，后面手动配
-
Filter models by provider → 保持
All providers，直接回车
-
Default model → 选
Keep current
-
Channels → 选择
Telegram，填入你刚才拿到的 Bot Token。向导会自动完成管理员配对
-
Configure skills now? → 选
No
-
Enable hooks? → 建议全选（
boot-md、bootstrap-extra-files、command-logger、session-memory都挺实用）
-
Install Gateway service → 选
Yes（开机自启） -
How do you want to hatch your bot? → 选
Do this later
向导在背后帮你完成了以下工作：
- 生成配置文件：默认写入
~/.openclaw/openclaw.json - 开启 systemd lingering：确保退出 SSH 后服务持续运行
- 安装 systemd 服务：服务器重启后 Bot 自动拉起
- 验证 Telegram 连接：看到
Telegram: ok说明连接成功
向导跑完后会提示 Onboarding complete。基础环境部署完成！
第四步：注入 AIGoCode 中转模型配置
AIGoCode 是兼容 Anthropic API 格式的中转服务，国内稳定访问，按量计费，支持 Claude Opus 4.6、Sonnet、GPT-4o 等主流模型。
打开配置文件：
# 如果有 nano：
nano ~/.openclaw/openclaw.json
# 如果没有 nano，用 vi：
vi ~/.openclaw/openclaw.json
# 或者先装 nano：
sudo apt install -y nano
在文件的最外层大括号内，找到合适位置（紧跟在 meta 块后面），插入以下两段配置（替换你的真实 AIGoCode API Key）：
"models": {
"providers": {
"aigocode": {
"baseUrl": "https://api.aigocode.com",
"apiKey": "sk-这里填你的AIGoCode的APIKey",
"api": "anthropic-messages",
"models": [
{
"id": "claude-opus-4-6",
"name": "Claude Opus 4.6 (AIGoCode)",
"reasoning": true,
"input": ["text", "image"],
"contextWindow": 200000,
"maxTokens": 16384
}
]
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "aigocode/claude-opus-4-6"
}
}
}
踩坑提醒：如果配置文件里已经有
agents字段（向导可能生成了一个默认的），你需要合并到一起，而不是直接粘贴第二份。JSON 里同一层级不能有两个同名的 key，否则后面的会覆盖前面的，导致模型配置丢失报错。
下图是初始配置文件的样子——没有 models 模块，所以可以把完整的 models 模块直接粘贴进去；但已经有 agents 模块，所以要把 model 字段合并到现有的 agents 里。
保存退出（Ctrl+O 回车保存，Ctrl+X 退出）。
api 字段说明：
anthropic-messages：用于 Claude 系列模型（Claude Opus 4.6、Sonnet 等）openai-responses：用于 GPT 系列及大部分兼容 OpenAI 格式的开源模型
第五步：重启服务，生效配置
配置文件修改后，需要重启 OpenClaw 才能生效：
openclaw gateway restart
重启完成后，确认服务运行状态：
openclaw gateway status
只要状态是 active (running) 就没问题，继续下一步配对。
第六步：Telegram 配对
重启成功后，打开 Telegram，给你的 Bot 发一条任意消息（"哈喽"、"你好"都行）。Bot 会回复一段配对信息：
OpenClaw: access not configured.
Your Telegram user id: xxxxxxxx
Pairing code: XXXXXXXX
这是正常的，因为还没有完成身份绑定。复制最后一行，回到服务器终端执行：
openclaw pairing approve telegram <你的配对码>
看到 Approved 提示后，回到 Telegram 再发一条消息，Bot 就能正常回复了。部署完成。
总结
整个流程 6 步：安装程序 → 申请机器人 → 跑向导 → 改配置 → 重启 → 配对。
向导帮你搞定环境和渠道，配置文件帮你接入中转模型，各司其职。跑起来了，后续想加更多模型或者换渠道，和机器人聊，让它操作就行。
常见问题
No API key found for provider anthropic
检查配置文件，models 和 agents 板块是否正确，primary 是否指向了 aigocode/claude-opus-4-6。
端口被占用（EADDRINUSE）
用 ss -tlnp | grep 18789 排查占用进程。
openclaw: command not found
运行 npm list -g openclaw 确认安装成功。如果安装了但命令找不到，运行 npm config get prefix 查看路径并添加到 PATH。