Crazyrouter API Document
中文
  • 中文
  • 🇺🇸 English
中文
  • 中文
  • 🇺🇸 English
中文
  • 中文
  • 🇺🇸 English
API 参考
快速开始接入教程官网模型与价格控制台
API 参考
快速开始接入教程官网模型与价格控制台
  1. 各种插件/软件使用教程
  • 默认模块
    • 在线调试说明
    • 发出请求
    • Crazyrouter基本介绍
      • API 快速开始指南
    • 聊天(Chat)
      • ChatGpt 接口
        • ChatGPT音频(Audio)
          • 音频转文字 gpt-4o-transcribe
          • 创建翻译(whisper-1,音频→英文,未实测)
        • ChatGPT聊天(Chat)
          • 聊天完成对象
          • 聊天完成块对象
          • 创建聊天补全 (流式)
          • 创建聊天补全 (非流)
          • 创建聊天识图 (流式)
          • 创建聊天识图 (流式) best64
          • 创建聊天识图 (非流)
          • 创建聊天创作图 (非流)
          • 官方Function calling调用
          • 官方N测试
          • 创建聊天函数调用
          • 创建结构化输出
          • 控制推理模型努力程度
          • 创建聊天补全 qwen-mt-turbo
          • 创建聊天补全 deepseek v3.1思考程度 (流式)
          • deepseek-ocr 识别
        • ChatGPT自动补全(Completions)
          • 完成对象
        • ChatGPT嵌入(Embeddings)
          • 嵌入对象
          • 创建嵌入
        • Web 搜索
          • web搜索
        • ChatGPT内容审核(Moderations)
          • 内容审核 Moderations
      • Anthropic Claude 接口
        • 聊天完成对象
        • 聊天完成块对象
        • 计算输入 Token 数 count_tokens [原生格式]
        • PDF支持 [原生格式] base64格式
        • 创建函数调用 (流式) [原生格式]
        • 创建思考聊天 [原生格式]
        • 创建思考聊天
        • 创建聊天补全 (流式)
        • 创建聊天补全 (非流)
        • 创建聊天识图 (流式)
        • 创建聊天识图 (非流)
        • PDF支持 [原生格式]
      • 谷歌Gemini 接口
        • 原生格式
          • 创建上下文缓存 cachedContents [原生格式]
          • 文本生成(非流式)gemini-2.5-pro [原生格式]
          • 文本生成(非流式)gemini-3.1-pro [原生格式]
          • 文本生成+思考-流
          • 图片生成 gemini-2.5-flash-image 控制宽高比
          • 文本生成+思考-流 gemini-3.1-pro [原生格式]
          • 图片生成 gemini-3-pro-image-preview 控制宽高比 +清晰度
          • google search
          • 视频理解-url [原生格式] 开发中
          • 图片理解
          • 格式化输出
          • 函数调用
          • 文档理解
          • 代码执行
          • 视频理解
          • URL context
          • 音频理解
        • chat兼容格式
          • gemini图片创作接口 [chat兼容格式]
          • 聊天接口 [chat兼容格式]
          • 聊天接口-思考1 [chat兼容格式]
          • 聊天接口-思考2 [chat兼容格式]
          • 识图接口 [chat兼容格式]
          • 聊天+读取文件接口 [chat兼容格式]
    • 聊天(Responses)
      • Responses API 与 Chat API 对比
      • 创建函数调用
      • 创建模型响应(流式返回)
      • 创建模型响应 (控制思考长度)
      • 创建网络搜索
      • 创建模型响应 gpt-5启用思考
    • 绘画模型
      • 图像对象
      • Midjourney
        • 上传图片
        • 提交Imagine任务
        • 根据任务ID 查询任务状态
        • 根据ID列表查询任务
        • 获取任务图片的seed
        • 执行Action动作
        • 提交Blend任务
        • 提交Describe任务
        • 提交Modal
        • 提交 Video 任务(图生视频)
        • 提交 Edits 任务(局部编辑)
        • 提交 Change 任务(U/V/R 变化)
        • 提交 Simple Change 任务(字符串形式)
        • 提交 Shorten 任务(提示词精简)
        • InsightFace 换脸
        • 获取任务图片(网关转存)
      • GPT Image 系列(gpt-image-2)
        • 创建图片(gpt-image-2,OpenAI images/generations 格式)
        • 编辑图片(gpt-image-2,蒙版 / 多图参考)
      • 即梦绘画
        • 创建绘画
        • 编辑图片
      • 豆包系列
        • doubao-seedream-3-0-t2i-250415
        • doubao-seededit-3-0-i2i-250628
        • doubao-seedream-4-0-250828-文生图
        • doubao-seedream-4-0-250828-图生图
        • doubao-seedream-4-0-250828-多图生图
        • doubao-seedream-4-5-251128 文生图(纯文本输入单图输出)
        • doubao-seedream-4-5-251128 图文生图(单图输入单图输出)
        • doubao-seedream-4-5-251128 多图融合(多图输入单图输出)
        • doubao-seedream-4-5-251128 组图输出(多图输出)
        • doubao-seedream-4-5-251128 单张图生组图
        • doubao-seedream-4-5-251128 多参考图生组图
      • 千问 Qwen-Image 系列
        • qwen-image-2.0-pro
        • qwen-image-edit-2509
    • 视频模型
      • veo 视频生成
        • 视频统一格式
          • 统一视频接口 任务状态
          • 创建视频,带图片
          • 创建视频(参考图)
        • OpenAI 视频格式
      • Kling 快手可灵
        • Callback协议
        • 全能视频 omni-video(kling-v3-omni / kling-video-o1)
        • 图像生成
        • 文生视频
        • 图生视频
        • 查询任务(免费)
        • 多图参考生视频
        • 对口型
        • 视频延长
        • 视频特效
      • 即梦 视频生成
        • 即梦 任务状态
        • 提交视频生成任务
        • 查询视频任务(免费)
      • 海螺 视频生成
        • 海螺 任务状态
        • 首尾帧视频
        • 视频任务状态查询
        • 图生视频
      • 豆包 视频生成
        • seedance-lite-参考图
        • 图生视频-首帧
        • 查询单个任务
        • seedance-lite-首尾帧
        • 图生视频-base64编码
      • sora 视频生成
        • OpenAI官方视频格式
          • openai 查询任务
          • openai 下载视频
          • openai 创建视频,带图片
          • 使用故事板创建视频
          • openai 创建视频,带图片 私有模式
          • openai 创建视频(带Character)
      • 通义万象 视频生成
        • 生成视频
        • 视频查询
      • 统一视频接口(所有视频模型通用)
        • 提交视频生成任务(统一格式)
        • 查询视频任务(统一格式)
    • 系统API
      • 查询异步任务(图片 / 视频通用)
      • 获取单个模型信息
      • 获取令牌列表
      • 新增令牌
      • 获取令牌支持模型
      • 修改令牌
      • 获取账号信息
      • 搜索令牌
      • 删除令牌
    • 文生音乐 Suno
      • Suno 说明
      • Suno 参数
      • 任务提交
        • 生成歌曲(拼接歌曲)
        • 生成歌词
        • 生成歌曲(自定义模式)
        • 歌曲拼接
        • 生成歌曲(续写模式)
        • 生成歌曲(歌手风格)
        • 生成歌曲(上传歌曲二次创作)
      • 查询接口
        • 批量获取任务
        • 查询单个任务
        • 获取wav
    • Python配置方式
      • python 语音转文本(whisper-1)
      • python 使用 Embeddings 向量化
      • python 调用 function-calling demo
      • python langchain 调用 demo
      • python llama_index 配置
      • Python 基础对话
      • Python 识别本地图片(多模态)
      • Python 识别网络图片(多模态)
      • Python 使用 Claude 识别图片
      • python 库流式输出
      • python requests 流式输出 demo
      • python 图像生成与编辑(gpt-image-2)
      • python openai 官方库(AutoGPT / langchain 等)
      • python 连续对话
    • Rerank 重排序模型
      • 重排序
    • php配置方式
      • php使用图片编辑demo
    • nodejs 配置方式
      • nodejs 基础对话
    • 各种插件/软件使用教程
      • CherryStudio配置o4推理级别
      • Cursor 配置教程
      • OpenClaw 安装与配置指南
      • Codex 配置教程
      • N8N 工作流使用 Crazyrouter API 教程
      • Gemini CLI 配置使用教程
      • Claude Code 安装使用教程
      • CherryStudio调用cluade MCP
      • Cherry Studio配置教程
      • dify添加模型
      • cline 配置教程
      • aider 配置教程
      • lobechat 设置教程
      • ChatBox(推荐使用)
      • 开源gpt_academic
      • nextchat 设置教程
      • zotero gpt 配置方法
      • CLAUDE DEV 配置教程
      • 沉浸式翻译 设置gpt翻译
      • 浏览器插件ChatGPT Sidebar
      • chatgpt-on-wechat 配置教程
      • chatgpt GPT Academic 学术优化配置gpt教程
      • RikkaHub 配置教程
      • coze 工作流使用 Crazyrouter API 教程
    • 帮助中心
      • AI返回字段: 思考相关
      • HTTP状态码及其含义
      • 自建图床API
    • 文件上传
      • 临时图片
        • 获取预签名直传地址(大文件推荐)
        • 本地图片临时上传
        • Base64 图片临时上传
        • 远程图片转存为临时 URL
      • Playground
        • Playground 图片上传
      • 废弃接口
        • 旧上传接口(不支持)
    • Decisions API(TypeSafe JEV 判定模型)
      • 创建判定 Decisions
    • 3D 模型生成(混元 hy-3d)
      • 提交 3D 生成任务
      • 查询 3D 生成任务
  • Unified Video API
    • Unified Video
  1. 各种插件/软件使用教程

OpenClaw 安装与配置指南

一键部署 OpenClaw#

在 Linux 或 macOS 上使用 Crazyrouter 快速部署 OpenClaw,并完成 WebUI、Telegram 与日常运维配置
更新日期:2026-06-06
通过一键脚本在 Linux 或 macOS 上部署 OpenClaw AI 网关,使用 Crazyrouter 作为默认后端。安装器会写入可直接运行的 ~/.openclaw/openclaw.json、注册系统服务,并预配置一组适合聊天、编码和长上下文任务的模型。

概览#

OpenClaw 适合把 Crazyrouter 变成一个你自己可控的本地 AI 入口:
本地 WebUI / 网关,默认监听 18789
可直接复用 Crazyrouter 的模型与额度
支持 Telegram,并预启用钉钉、企业微信、QQ Bot、Discord、Slack、飞书等插件入口
适合个人常驻机器人、团队内部助手、家庭服务器或轻量自托管场景

适合谁用#

想用一条命令把 Crazyrouter 接到本地 AI 网关的人
想把 Telegram Bot 跑在自己的服务器上的人
想统一管理聊天、WebUI、IM 入口的人
想给开发机或家用小主机部署常驻助手的人

使用协议#

推荐协议:OpenAI-compatible API
安装器默认把 crazyrouter provider 指向 https://api.crazyrouter.com/v1
同时会写入 crazyrouter-claude、crazyrouter-minimax provider,便于切换到 Anthropic Messages 兼容路径
OpenClaw 自身对外暴露的是本地网关和 WebUI,认证依赖安装时生成的 gateway.auth.token
Note: 如果你后续要手动调整 OpenClaw 的 provider 地址,先参考 API Endpoint 说明,确认当前客户端应该填写根域名还是 /v1。

前置条件#

项目说明
Crazyrouter 账号先在 crazyrouter.com 注册
Crazyrouter API Key建议为 OpenClaw 单独创建一个 token,不要与 Cursor、Claude Code 共用
操作系统Linux 或 macOS,x64 / arm64 均可
网络服务器需要能访问公网;如果你要从其他设备访问 WebUI,还要放行 18789 端口
Node.js安装器会尽量自动安装 Node.js 22+
Telegram Bot Token可选,仅在你要接 Telegram 时需要
Warning: OpenClaw 安装器默认把网关绑定到局域网地址(bind: lan)。如果你的主机直接暴露公网,请务必同时做好防火墙限制,并妥善保管网关登录 token。

5 分钟快速开始#

创建专用 Crazyrouter token#

在 Crazyrouter 后台创建一个专门给 OpenClaw 使用的 sk-... token。建议先只放行你打算在网关里使用的模型,例如 claude-opus-4-8、gpt-5.5、gemini-3.1-pro。

运行安装脚本#

如果你想跳过语言选择和 API Key 输入,也可以这样:

记下安装器输出的 3 个值#

WebUI 地址:http://<服务器IP>:18789
自动登录地址:http://<服务器IP>:18789?token=<gateway_token>
配置文件:~/.openclaw/openclaw.json

打开 WebUI 做第一次验证#

用浏览器访问自动登录地址,确认能够进入 OpenClaw 控制台,并用默认模型 claude-opus-4-8 发一条测试消息,例如“只回复 ok”。

按需完成 Telegram 配对#

安装器会询问是否立即设置 Telegram。若选择立即配置,填入 Bot Token 后,给你的机器人发送任意一条消息即可完成首个 owner 配对。

推荐模型配置#

安装器默认主模型是 claude-opus-4-8。如果你想切换日常默认模型,直接修改 ~/.openclaw/openclaw.json 里的 agents.defaults.model.primary。
场景推荐模型原因
默认日常聊天claude-opus-4-8当前默认主模型,适合作为高质量日常聊天与主控模型
编码 / Agentgpt-5.5最新 OpenAI 兼容主力模型,适合作为编码与 Agent 主基线
高性价比备用claude-opus-4-8质量、稳定性和成本比较均衡
Gemini 备用档gemini-3.1-pro适合作为第二条兼容性验证路径
深度推理claude-opus-4-8适合需要更强推理链的场景
示例:把默认模型改成 gpt-5.5
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "crazyrouter/gpt-5.5"
      }
    }
  }
}
如果你想显式走 Claude 兼容 provider,可以这样写:
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "crazyrouter-claude/claude-opus-4-8"
      }
    }
  }
}

Token 设置最佳实践#

设置建议说明
专用 token必须不要把 OpenClaw 和其他 IDE / CLI 共用同一个 token
模型白名单建议开启只保留 OpenClaw 会用到的模型,减少误用
IP 限制固定出口服务器建议开启如果你的主机出口 IP 固定,可把 token 限制到这台服务器
配额上限建议设置给机器人场景单独设月度或日度预算
环境隔离建议生产机器人和测试机器人分开 token
泄露处理立即轮换如果 openclaw.json、日志或分享链接暴露过 token,应立即重置 Crazyrouter token 和网关 token
Tip: OpenClaw 里至少有两类凭证:一类是 Crazyrouter 的 sk-... API Key,用来调用模型;另一类是 OpenClaw 本地网关登录 token,用来进入 WebUI。两者不要混用。

首次成功检查清单#

浏览器能打开 http://<服务器IP>:18789?token=<gateway_token>
OpenClaw WebUI 能正常进入,不会循环要求登录
默认模型可以成功返回第一条消息
修改模型后,重启服务仍能正常响应
journalctl --user -u openclaw -f 或 tail -f ~/.openclaw/openclaw.log 能看到成功请求
如启用 Telegram,给机器人发消息后能够收到回复
已保存 ~/.openclaw/openclaw.json 备份

关键文件与配置项#

文件位置#

路径用途
~/.openclaw/openclaw.json主配置文件
~/.openclaw/start-gateway.sh启动脚本,系统服务实际调用它
~/.openclaw/crash-guard.cjs安装器写入的稳定性补丁
~/.openclaw/credentials/.telegram-owner-pairedTelegram 首个 owner 完成配对后的标记文件
~/.config/systemd/user/openclaw.serviceLinux 用户级 systemd 服务
~/Library/LaunchAgents/com.crazyrouter.openclaw.plistmacOS launchd 服务
~/.openclaw/openclaw.logmacOS 常规日志
~/.openclaw/openclaw.errmacOS 错误日志

最常改的配置项#

JSON 路径作用常见修改
models.providers.crazyrouter.apiKeyCrazyrouter OpenAI 兼容 key更换 API Key
models.providers.crazyrouter.baseUrlOpenAI 兼容基址通常保持 https://api.crazyrouter.com/v1
agents.defaults.model.primary默认主模型切换到 gpt-5.5、claude-opus-4-8 等
gateway.portWebUI / 网关端口改成你自己的端口
gateway.auth.tokenWebUI 登录 token泄露后立即更换
gateway.bind监听范围默认是 lan
channels.telegram.botTokenTelegram Bot Token启用 Telegram 时填写
plugins.entries.*.enabled各 IM 插件是否启用按需关闭未使用插件
env.vars.OPENAI_API_KEY给某些内部能力复用的 API Key通常保持与主 key 一致

IM 接入#

Telegram#

这是安装器支持最完整的渠道,建议优先从 Telegram 开始:
1.
在 Telegram 搜索 @BotFather
2.
发送 /newbot 创建机器人,并拿到 Bot Token
3.
安装器询问 Set up Telegram Bot now? 时选择 Y
4.
粘贴 Bot Token,安装器会把它写入 ~/.openclaw/openclaw.json
5.
安装器自动重启网关后,给机器人发送任意一条消息
6.
第一位发送消息的人会被自动配对为 owner
7.
如果自动配对失败,执行:
手动补写 Telegram 配置时,可参考安装器写入的结构:
{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "123456789:ABCdef...",
      "dmPolicy": "pairing",
      "groupPolicy": "allowlist",
      "streaming": "off"
    }
  },
  "plugins": {
    "entries": {
      "telegram": { "enabled": true }
    }
  }
}

其他 IM 平台#

安装器会预启用以下插件入口:
dingtalk
openclaw-wecom
qqbot
discord
slack
feishu
但这些渠道通常还需要你自己补充平台凭证和对应的 channels.<name> 配置。推荐流程是:
1.
先在对应平台创建机器人或应用
2.
把平台凭证写入 ~/.openclaw/openclaw.json
3.
确认对应 plugins.entries.<name>.enabled 为 true
4.
重启 OpenClaw 服务
5.
通过日志验证该渠道是否成功加载
平台安装器状态你还需要做什么
Telegram支持交互式配置填 Bot Token,完成 owner 配对
钉钉插件会安装并启用补充机器人凭证和对应 channel 配置
企业微信插件会安装并启用补充企业应用凭证和对应 channel 配置
QQ Bot插件会安装并启用补充机器人凭证和对应 channel 配置
Discord / Slack / 飞书插件入口已启用按各自机器人配置要求补充 channel 凭证
Note: 如果你准备把 OpenClaw 接入团队 IM,强烈建议为团队机器人单独创建 Crazyrouter token,并设置更严格的模型白名单和配额。

服务管理与日志#

Linux (systemd)#

说明:安装器会尝试执行 loginctl enable-linger $(whoami),这样即使你退出 SSH,会话外的用户级服务也能继续运行。

macOS (launchd)#

说明:macOS 下 openclaw.log 通常看运行日志,openclaw.err 更适合排查启动失败。

性能与成本建议#

默认先用 claude-opus-4-8,确认整体流程跑通后再做模型分工
高频日常问答或机器人通知场景,可按成本回退到 claude-opus-4-8 或 gemini-3.1-pro
编码类工作流单独切到 gpt-5.5
团队场景把 Telegram / 企业 IM / WebUI 分成不同 token,便于成本核算和风险隔离
只保留必要插件和必要模型,减少误调用成本

升级指南#

最稳妥的升级方式是重新运行安装器,因为它会一起处理 OpenClaw 包、补丁和服务脚本:

备份当前配置#

重新执行安装脚本#

检查自定义配置是否需要回填#

如果你手动加过 Telegram 以外的 channel 或改过默认模型,重新对比 openclaw.json,确保这些自定义项仍然存在。

重启并验证#

重新打开 WebUI,确认模型、日志和已接入的 IM 渠道都正常。
如果你明确知道自己只想升级 OpenClaw npm 包,也可以先执行 npm install -g openclaw@latest,再重启服务;但这种方式不会帮你重新应用安装器里的补丁与脚本更新。

卸载指南#

Linux#

macOS#

如果你当初是专门为了 OpenClaw 安装 Node.js,也可以在确认没有其他项目依赖后再手动移除 Node.js。

常见错误与修复#

现象常见原因修复方式
WebUI 打不开服务未启动、端口被占用、主机防火墙未放行先看服务状态,再检查 18789 端口和防火墙
页面能打开但一直要求登录gateway.auth.token 不对,或你访问的不是自动登录地址重新读取安装器输出的 ?token=... 链接,必要时检查 openclaw.json
401 unauthorizedmodels.providers.*.apiKey 里的 Crazyrouter key 无效或已失效更新 API Key 后重启服务
403 / model not allowedOpenClaw 正在请求的模型不在 Crazyrouter token 白名单中在 token 设置里放行对应模型
429 / 配额耗尽token 超额或速率限制触发提高配额、换更便宜模型,或拆分 token
修改模型后仍调用旧模型服务未重启,或改错了 provider 路径检查 agents.defaults.model.primary,然后重启
Telegram Bot 不回复未写入 botToken、未完成 owner 配对,或服务未重启检查 channels.telegram、重启服务、重新发消息触发配对
Linux 安装后提示服务可能未启动systemd 用户服务失败运行 journalctl --user -u openclaw -f 看错误
macOS 安装后提示服务可能未启动launchd 启动失败查看 ~/.openclaw/openclaw.err

FAQ#

应该使用哪个地址作为 Crazyrouter 后端?#

默认保持安装器写入的值即可:OpenAI 兼容 provider 用 https://api.crazyrouter.com/v1,Claude / MiniMax 原生兼容 provider 用 https://api.crazyrouter.com。

应该保留哪个默认模型?#

大多数情况下先保留 claude-opus-4-8。如果你主要把 OpenClaw 当代码助手,再切到 gpt-5.5。

为什么模型列表里看不到我想用的模型?#

通常是你的 Crazyrouter token 没放行该模型,或你改成了错误的 provider 前缀。

为什么 Telegram 私聊可以,群聊不行?#

安装器默认把 Telegram 组策略设为 allowlist。你需要按自己的使用需求继续调整 Telegram channel 配置。

怎样最安全地对外开放 OpenClaw?#

最少要做到三件事:限制来源访问、保护好 gateway.auth.token、为 OpenClaw 使用单独的 Crazyrouter token。若直接暴露公网,建议再加反向代理和额外访问控制。
查看安装脚本仓库
查看安装脚本、提交 Issue,或手动审查一键安装逻辑。

最后校验/修改:2026-09-28(API Base URL 由 cn.crazyrouter.com 统一改为 https://api.crazyrouter.com,共 4 处;账号/控制台仍为 https://crazyrouter.com)
Modified at 2026-09-28 08:56:56
Previous
Cursor 配置教程
Next
Codex 配置教程
Built with