OpenClaw 接入
基于 OpenClaw 官方安装和配置方式,把自托管 AI 助手接到 TokenFlash。
OpenClaw 是一个自托管 AI 助手网关。它可以把 Telegram、飞书、Discord、WhatsApp 等消息入口统一接到同一个 AI 后端。对 TokenFlash 来说,它最适合作为“多渠道助手入口”。

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