1. 主流工具安装和接入教程
FlayApi
  • 站点操作指南-快速上手调用大模型API
  • 站点模型分组介绍
  • 主流工具安装和接入教程
    • CC Switch接入flyapi教程
    • chatbox接入教程
    • cherry studio接入教程
    • claude code安装教程(win/mac)
    • Claude Desktop接入flyapi教程
    • codex桌面版接入flyapi教程
    • coze使用flyapi教程
    • Cursor接入flyapi教程
    • Dify 配置使用flyapi教程
    • Gemini cli 接入flyapi教程
    • GPT-codex安装教程
    • Hermes Agent安装接入flyapi教程
    • n8n 配置使用flyapi 教程
    • openclaw接入flyapi教程
    • opencode接入flyapi教程
    • Trae 接入flyapi教程
    • VScode安装cc插件教程(未安装CC终端使用)
    • WorkBuddy接入flyapi教程
    • 腾讯云openclaw 接入flyapi教程
  1. 主流工具安装和接入教程

openclaw接入flyapi教程

openclaw安装配置#

前置条件:
在flyapi中获取到CLaude的 密钥/令牌(key)
node.js下载:https://nodejs.org/zh-cn/download

一.安装与基础初始化#

首先确保你已经安装了 Node.js 24+ 环境,然后在终端执行:

1.npm安装(推荐)#

npm install -g openclaw

2.安装完成后验证#

openclaw --version

3.初始化配置(配置文件默认生成在 ~/.openclaw/openclaw.json。)#

openclaw setup
image.png

二.配置openclaw#

1. 配置openclaw.json文件,按需替换 api地址和api key 和 访问token,覆盖原来的openclaw.json文件即可,后续可以运行openclaw config命令或者修改openclaw.json文件继续配置。#

之前有小龙虾,看下方只添加模型部分
或者可以命令小龙虾自己添加模型
openclaw.json
只添加模型
openclaw.json参考模板
{
"gateway": {
"port": 18789,
"mode": "local",
"auth": {
  "token": "flyapi"  //替换自己的访问令牌
},
"trustedProxies": ["127.0.0.1"],
"controlUi": {
  "allowedOrigins": ["*"],
  "allowInsecureAuth": true
}
},
"agents": {
"defaults": {
  "model": {
    "primary": "claude/claude-opus-4-6-thinking",
    "fallbacks": [
      "claude/claude-sonnet-4-6-thinking",
      "gpt/gpt-5.4",
      "gemini/gemini-3.1-pro-preview"
    ]
  },
  "imageModel": {
    "primary": "gemini-3.1-pro-preview"
  },
  "compaction": {
    "mode": "default"
  },
  "maxConcurrent": 4,
  "subagents": {
    "maxConcurrent": 8
  }
}
},
"models": {
"mode": "merge",
"providers": {
  "claude": {
    "baseUrl": "http://api.kailang.top/v1",
    "apiKey": "sk-",   //替换自己的key
    "api": "anthropic-messages",
    "models": [
      {
        "id": "claude-opus-4-6",
        "name": "Claude Opus 4.6",
        "reasoning": true,
        "input": ["text", "image"],
        "contextWindow": 200000,
        "maxTokens": 16384
      },
      {
        "id": "claude-sonnet-4-6-thinking",
        "name": "Claude Sonnet 4.6 思考版",
        "reasoning": true,
        "input": ["text", "image"],
        "contextWindow": 200000,
        "maxTokens": 8192
      }
    ]
  },
  "gpt": {
    "baseUrl": "http://api.kailang.top/v1",
    "apiKey": "sk-",   //替换自己的key
    "api": "openai-completions",
    "models": [
      {
        "id": "gpt-5.4",
        "name": "GPT-5.4",
        "reasoning": false,
        "input": ["text", "image"],
        "contextWindow": 200000,
        "maxTokens": 16384
      }
    ]
  },
  "gemini": {
    "baseUrl": "http://api.kailang.top/v1",
    "apiKey": "sk-",  //替换自己的key
    "api": "openai-completions",
    "models": [
      {
        "id": "gemini-3.1-pro-preview",
        "name": "Gemini 3.1 Pro",
        "reasoning": true,
        "input": ["text", "image"],
        "contextWindow": 1048576,
        "maxTokens": 65536
      },
      {
        "id": "gemini-3-pro-image-preview",
        "name": "Gemini 3 Pro image",
        "reasoning": true,
        "input": ["text", "image"],
        "contextWindow": 1048576,
        "maxTokens": 65536
      }
    ]
  }
}
},
"messages": {
"ackReactionScope": "group-mentions"
},
"commands": {
"native": "auto",
"nativeSkills": "auto",
"restart": true
}
}  

2. 验证配置,有报错按提示修改,无报错继续。#

openclaw config validate
image.png

三.启动服务(启动可能有几十秒延迟)#

nohup openclaw gateway --force > /tmp/openclaw.log 2>&1 &

验证是否成功#

openclaw health

四.访问 Dashboard(openclaw仪表盘)#

浏览器打开(加token验证):
http://你的服务器IP:18789/#token=你设置的token令牌值
登录页面出现,“pairing”字样就需要验证
image.png
回到终端,输入openclaw devices list,出现下图,复制箭头指的Request值
openclaw devices list
image.png
再次输入openclaw devices approve 接上(Request值),如下图
openclaw devices approve (Request值)
image.png
返回浏览器,不要刷新,等一会自动连接,没有自动连接的话点概览,点连接
image.png

五.接入飞书和Telegram#

飞书
Telegram

创建飞书机器人#

进入飞书开放平台:https://open.feishu.cn
1.注册登录账号
2.开发者后台--创建企业自建应用--创建
image.png
3.添加应用能力--添加机器人
4.权限管理--开通权限--搜索im:开通所有消息相关权限(可自选)--确认开通
image.png
5.创建版本并发布(上方有提示)--填写保存并发布

openclaw连接飞书#

1.回到终端输入openclaw config回车
openclaw config
image.png
选择(空格勾选,回车选择):Local--Channels--Configgure/link--feishu(飞书)--Download from npm(安装飞书插件)--Enter App Secret回车--回到飞书开放平台--凭证与基础信息复制App Secret和App ID的内容--返回终端粘贴并回车--再粘贴App ID的内容回车--WebSocket--Feishu.cn China--Open re··--最下面Finished--yes--pairing--Continue
image.png
2.启动openclaw
3.回到飞书开放平台--事件与回调--订阅方式--选择长链接并保存--添加事件--搜索接收 勾选接收消息--确认添加--权限管理--开通权限--搜索通讯录勾选获取通讯录基本信息--确认开通权限--再次创建版本并发布
4.打开手机飞书app登录--开发者小助手--打开应用--和机器人对话
image.png
5.复制箭头指向的最后一段在终端运行
openclaw pairing approve feishu 配对码
回到飞书就能正常对话了
image.png

六.常用操作指令#

配置openclaw命令(配置向导,自动合并写入openclaw.json文件)#

openclaw configure

进程管理#

模型切换#

临时切换(在聊天中发送):
/model claude/claude-sonnet-4-6-thinking
模型管理
openclaw models list                    # 列出所有可用模型
openclaw models status                  # 查看当前默认模型
openclaw models set <provider/model>    # 设置默认主模型
openclaw models set-image <provider/model> # 设置图像模型
openclaw models scan                    # 扫描可用模型

配置管理#

openclaw config get <key>               # 读取配置值
openclaw config set <key> <value>       # 写入配置值
openclaw config unset <key>             # 删除配置值
openclaw configure                      # 交互式配置

# 示例
openclaw config set openai.api_key "sk-..."
openclaw config set messages.tts.auto "always"

更新#

更新后重启#

pkill -f "openclaw gateway" && sleep 2 && nohup openclaw gateway --force > /tmp/openclaw.log 2>&1 &

聊天框常见斜杆操作#

命令功能
/new开启全新会话
/stop中止当前运行的任务
/compact释放上下文窗口空间
/status显示健康状态和当前上下文
/context list列出所有上下文贡献者
/subagents list列出子智能体
/subagents info查看子智能体信息
/model查看当前使用的模型
/model list列出所有可用模型
/model <编号>按编号切换模型(如 /model 3)
/model <provider/model>按完整 ID 切换模型
/model status查看模型详细状态
/think开启 / 关闭推理模式
/reasoning on开启深度推理
/tts on开启文本转语音
/tts off关闭文本转语音

七.常见问题#

Q: 启动报 Invalid config 错误
检查 claude.api 是否为 anthropic-messages,不能写成 anthropic。
Q: 聊天报工具调用错误(function tag mismatch)
同上,claude.api 填错导致,改为 anthropic-messages 重启即可。
Q: systemctl restart openclaw 失败
容器环境无 systemd,使用 pkill + nohup 方式手动重启(见上方进程管理)。
Q: 模型请求超时/无响应
用 curl 直接测试对应 provider 的 key 和 baseUrl 连通性,确认 key 有效后重启服务。
修改于 2026-07-04 02:19:45
上一页
n8n 配置使用flyapi 教程
下一页
opencode接入flyapi教程
Built with