
这篇文章适合谁
如果你想做下面这些事情,这篇就适合你:- 想把 AI 助手接到 Telegram、飞书、Discord 等聊天入口
- 想自己部署一个可长期运行的 AI 助手
- 想让所有消息入口统一走 Xcompute 的模型能力
你最终会得到什么
做完这篇以后,你会得到:- 一个本地或服务器上的 OpenClaw 实例
- 一个已经接到 Xcompute 的模型后端
- 一个可以打开的控制台页面
- 一个可以继续扩展渠道接入的自托管 AI 助手底座
官方安装方式
如果你还没准备 Node 环境,先看 环境准备:NVM、Node.js 22 和 npm。OpenClaw 官方更推荐
Node 24,但 Node 22.16+ 仍然兼容。如果你当前整个文档站统一基于 Node 22,也可以先跑通。开始前你要准备什么
- 一台能联网的电脑或服务器
- 已安装好的
Node.js - 一把 Xcompute 的 API Key
- 你准备接入的消息渠道账号,例如 Telegram 或飞书
官方资源
接入 Xcompute 的推荐方式
官方推荐先运行onboard 向导。对 Xcompute 来说,最实用的做法是选择 OpenAI 兼容或自定义 provider,然后把基础地址切到 Xcompute。
第一步:先准备 Xcompute API Key
- 打开 Xcompute API 密钥页面
- 创建一把新密钥
- 先把密钥保存到安全位置
填写 Xcompute 信息
使用下面这组值:
Base URL:https://xcompute.us/v1API Key: 你的 Xcompute API KeyModel: 你要使用的模型 ID,例如gpt-5或claude-sonnet-4-5-20250929
第二步:确认是否真的接通了
你可以按下面的顺序确认:- 运行
openclaw gateway status - 打开
openclaw dashboard - 在控制台里发一条测试消息
- 如果有回复,说明接通成功
第三步:接消息渠道
第一次使用时,建议你不要同时接很多平台。 推荐顺序:- 先接一个最简单的平台
- 验证消息能进、回复能出
- 再继续接第二个渠道
- Telegram
- 飞书
- Discord
日常使用教程
1. 查看网关状态
2. 打开控制台
3. 配置消息入口
最常见的是 Telegram、飞书、Discord。建议先从一个最简单的渠道开始,不要一上来同时接很多渠道。4. 用专用密钥隔离渠道调用
建议给 OpenClaw 单独分配一把 API Key,避免和应用服务、Claude Code、OpenCode 共用。常见问题
控制台能打开,但消息没回复
先检查:- Xcompute 的 API Key 是否有效
Base URL是否填成了https://xcompute.us/v1- 模型名称是否可用
- 你接入的渠道是否配置完成
为什么建议先只接一个渠道
因为非技术用户最容易在“模型问题”和“渠道问题”同时出现时搞不清是哪边出了错。先跑通一个渠道,排查最轻松。什么时候适合用 OpenClaw
- 你想把 AI 助手接到 Telegram、飞书、Discord 等聊天入口
- 你想在自托管环境里统一管理消息入口和模型调用
- 你希望不同渠道共用同一套 Xcompute 模型出口
官方参考
- OpenClaw Getting started
- OpenClaw Gateway configuration
- OpenClaw channel docs