OpenClaw 接入指南
将 疾旋Token 接入 OpenClaw 开源自主 AI 助理框架,构建具备全天候自动化与多渠道消息联动的全自主 Agent 运行环境。
OpenClaw 是一款开源、自托管的 24/7 全自主个人 AI 助理框架(GitHub: openclaw/openclaw)。
与传统的单轮对话 Chatbot 不同,OpenClaw 基于中心化 Gateway 控制网关架构(默认运行在 18789 端口),能够在后台自主执行终端命令、读写工作区文件、浏览网页并管理复杂长程任务,并原生接入 Telegram、Discord、Slack、WhatsApp 等即时通讯平台。
将 疾旋Token 接入 OpenClaw 后,可为 Agent 提供极速、高稳定且支持超长上下文的代码理解与复杂工具调度算力。
📦 安装与初始化
# 官方一键安装脚本
curl -fsSL https://openclaw.ai/install.sh | bash
# 运行初始化向导
openclaw onboard⚙️ 接入配置方式
OpenClaw 支持通过 修改主配置文件、CLI 命令行 或 Web Control UI 三种方式进行配置。
方式一:编辑配置文件 openclaw.json(官方推荐)
OpenClaw 的核心配置文件位于 ~/.openclaw/openclaw.json(采用支持注释的 JSON5 格式)。
打开该文件,在 models.providers 节点中添加疾旋Token 供应商配置,并在 agents.default 中指定默认模型:
{
"models": {
"mode": "merge",
"providers": {
// 定义疾旋Token 供应商
"jixuan-token": {
"baseUrl": "https://token.astrumflow.com/v1",
"apiKey": "sk-your-astrumflow-token-key", // 建议也可使用 "env:OPENAI_API_KEY"
"api": "openai-completions",
"models": [
{
"id": "GPT-5.6-sol",
"name": "GPT-5.6-sol 旗舰推理",
"contextWindow": 200000,
"maxTokens": 8192
},
{
"id": "GPT-5.6-terra",
"name": "GPT-5.6-terra 高性能主力",
"contextWindow": 128000,
"maxTokens": 8192
},
{
"id": "GPT-5.6-luna",
"name": "GPT-5.6-luna 极速响应",
"contextWindow": 64000,
"maxTokens": 4096
}
]
}
}
},
// 设置默认 Agent 绑定的模型
"agents": {
"default": {
"model": "jixuan-token/GPT-5.6-sol"
}
}
}参数规范:
baseUrl:必须以/v1结尾。api:标准 OpenAI 格式填写"openai-completions";如果后端支持 Responses 协议,也可选"openai-responses"。
方式二:通过 OpenClaw CLI 命令动态配置
如果您偏好在终端中直接操作,可以使用 openclaw config set 命令动态写入配置:
# 1. 设置 Base URL 与 API 协议类型
openclaw config set models.providers.jixuan-token.baseUrl "https://token.astrumflow.com/v1"
openclaw config set models.providers.jixuan-token.api "openai-completions"
# 2. 设置 API Key 认证密钥
openclaw config set models.providers.jixuan-token.apiKey "sk-your-astrumflow-token-key"
# 3. 指定主力默认模型
openclaw config set agents.default.model "jixuan-token/GPT-5.6-sol"方式三:通过 Control UI 可视化面板配置
- 在终端运行
openclaw gateway start启动网关服务。 - 打开浏览器访问 OpenClaw Control UI 控制面板。
- 进入 Settings -> Model Providers。
- 点击 Add Provider,输入名称
jixuan-token,选择OpenAI Compatible,填入 Base URLhttps://token.astrumflow.com/v1及 API Key 并保存。
🔍 连通性测试与排错诊断
完成配置后,您可以通过以下命令检查疾旋Token 节点的就绪状态:
验证模型加载清单
运行以下命令,确认 OpenClaw 已正确解析疾旋Token 的模型:
openclaw models list --provider jixuan-token若终端正确列出 GPT-5.6-sol、GPT-5.6-terra 等模型,说明供应商配置格式正确。
启动 Agent 交互会话
启动 OpenClaw 全屏终端界面 (TUI) 或向后台 Agent 发送一条测试任务:
# 启动交互式 TUI
openclaw tui
# 或执行单次指令
openclaw chat send "请帮我检查当前目录下的 git 提交日志并生成一份简要总结"