从全新 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

第一步：安装 OpenClaw

  在服务器终端执行一行命令，全局安装 OpenClaw：

  sudo npm install -g openclaw

  看到安装成功的提示后，核心程序就位了。

第二步：申请 Telegram 机器人

  在 Telegram 里搜索 @BotFather（认准蓝色官方认证标记），按以下步骤操作：

  发送 /newbot

1. 1. 按提示给机器人起一个昵称（支持中文，后续可改）
2. 2. 设置一个唯一的用户名（必须以 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

向导在背后帮你完成了以下工作：

1. 1. 生成配置文件：默认写入 ~/.openclaw/openclaw.json
2. 2. 开启 systemd lingering：确保退出 SSH 后服务持续运行
3. 3. 安装 systemd 服务：服务器重启后 Bot 自动拉起
4. 4. 验证 Telegram 连接：看到 Telegram: ok 说明连接成功

  向导跑完后会提示 Onboarding complete。基础环境部署完成！

第四步：注入 AIGoCode 中转模型配置

AIGoCode 是兼容 Anthropic API 格式的中转服务，国内稳定访问，按量计费，支持 Claude Opus 4.6、Sonnet、GPT-4o 等主流模型。

打开配置文件：

javascript

▼ 展开

  在文件的最外层大括号内，找到合适位置（紧跟在 meta 块后面），插入以下两段配置（替换你的真实 AIGoCode API Key）：

javascript

▼ 展开

踩坑提醒：如果配置文件里已经有 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 会回复一段配对信息：

javascript

▼ 展开

  这是正常的，因为还没有完成身份绑定。复制最后一行，回到服务器终端执行：

javascript

▼ 展开

  看到 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。

  从全新 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

第一步：安装 OpenClaw

  在服务器终端执行一行命令，全局安装 OpenClaw：

  sudo npm install -g openclaw

  看到安装成功的提示后，核心程序就位了。

第二步：申请 Telegram 机器人

  在 Telegram 里搜索 @BotFather（认准蓝色官方认证标记），按以下步骤操作：

  发送 /newbot

1. 1. 按提示给机器人起一个昵称（支持中文，后续可改）
2. 2. 设置一个唯一的用户名（必须以 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

向导在背后帮你完成了以下工作：

1. 1. 生成配置文件：默认写入 ~/.openclaw/openclaw.json
2. 2. 开启 systemd lingering：确保退出 SSH 后服务持续运行
3. 3. 安装 systemd 服务：服务器重启后 Bot 自动拉起
4. 4. 验证 Telegram 连接：看到 Telegram: ok 说明连接成功

  向导跑完后会提示 Onboarding complete。基础环境部署完成！

第四步：注入 AIGoCode 中转模型配置

AIGoCode 是兼容 Anthropic API 格式的中转服务，国内稳定访问，按量计费，支持 Claude Opus 4.6、Sonnet、GPT-4o 等主流模型。

打开配置文件：

javascript

▼ 展开

  在文件的最外层大括号内，找到合适位置（紧跟在 meta 块后面），插入以下两段配置（替换你的真实 AIGoCode API Key）：

javascript

▼ 展开

踩坑提醒：如果配置文件里已经有 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 会回复一段配对信息：

javascript

▼ 展开

  这是正常的，因为还没有完成身份绑定。复制最后一行，回到服务器终端执行：

javascript

▼ 展开

  看到 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。