星狐API使用文档
    • 前言
    • 如何使用星狐云API?
    • OpenClaw配置API教程
    • HermesAgent配置星狐云 API 使用教程
    • Claude Code配置星狐云API教程【最新】
    • Vscode配置API使用教程
    • Codex配置星狐云API教程
    • CC Switch配置API教程
    • Obsidian 使用 Claudian教程
    • WorkBuddy配置API教程
    • 幻墨AI画图工具使用教程
    • 星狐Claw 一键部署 OpenClaw 使用教程
    • Chatbox使用教程
    • Cherry Studio使用教程
    • Gemini CLI API配置教程
    • Cursor配置API使用教程
    • Trae配置API教程
    • N8N 工作流配置中转API 教程
    • Dify配置API教程
    • 酒馆AI使用教程
    • Lovemo配置教程
    • 批量请求示例
    • 常见问题及解决办法
    • 售后支持
    • Python调用代码示例
      • Python 对话模型调用示例教程
      • Gemini 生图模型调用教程
      • GPTImage-2 中转 API 调用教程

    OpenClaw配置API教程

    OpenClaw 是什么?一句话解读#

    OpenClaw 是由 Peter Steinberger (PSPDFKit 创始人) 开发的开源个人 AI 助手项目。与传统网页版 ChatGPT 或 Claude 不同,OpenClaw 直接运行在你常用的聊天软件里——你在 WhatsApp 发消息,它在 WhatsApp 回复;你在 Discord 提问,它在 Discord 解答。甚至可以对接到飞书、QQ、还有钉钉里面!
    💡
    官方中文文档链接
    🎯 关键理解: OpenClaw 不是一个 AI 模型,而是一个「AI 网关」——它负责连接你的聊天软件和 AI 大模型 API,让 AI 能力无缝融入日常沟通工具。
    特性OpenClaw传统 AI 聊天
    使用方式在常用聊天软件内使用需要打开专门网页
    对话记忆跨平台持久记忆每次对话独立
    主动推送支持定时提醒和主动通知只能被动响应
    数据存储本地 Markdown 文件存储在云端
    定制能力完全可编程 Skills 系统有限的自定义选项
    💡
    星狐Claw--OpenClaw一键部署工具已经上线,点击下载

    安装OpenClaw#

    安装最新版:
    Linux / MacOS 官方推荐方式:
    Windows PowerShell:
    iwr -useb https://openclaw.ai/install.ps1 | iex
    替代方式(全局安装):
    验证是否安装成功

    如何配置星狐云API到Openclaw#

    先启动配置向导
    image.png
    向导会引导你完成:
    AI 模型配置 – 支持各大AI平台模型设置,包括中转api
    工作目录设置 – 默认 ~/clawd
    渠道启用 – 选择要连接的聊天平台,支持TG、飞书、钉钉、企业微信等等
    守护进程安装 – 让 Gateway 后台持续运行
    image.png
    我们直接选择快速开始(QuickStart)
    image.png
    这里选择Custom Provider,开始配置星狐云API
    image.png
    image.png
    输入星狐云url:https://xinghuapi.com/v1
    输入星狐云创建的APIkey
    最后根据想用的模型选择兼容模式,默认选择OpenAI-compatible,如果想用claude模型就选择Anthropic-compatible
    image.png
    然后输入想调用的模型id,这里我们使用claude-sonnet-4-6模型示例参考,然后回车确认即可
    接下来就是设置要对接的聊天平台通道,支持各种聊天工具,Telegram、飞书等等,也可以直接选择Skip for now先跳过,后面再设置
    image.png
    image.png
    接下来是skills系统配置,可以暂时跳过或者根据自己需求配置
    image.png
    推荐四个都选择上(空格键勾选,回车键确定)
    完成后openclaw会自动开启gate网关,使用默认浏览器打开openclaw界面
    如果启动gate失败了,就手动启动
    image.png
    image.png
    image.png
    如果要退出openclaw,在PowerShell使用 Ctrl+C 快捷键

    如何配置Openclaw对接到Telegram#

    选择对接Telegram通道后,会要求输入TG机器人的token密钥
    image.png

    如何获取TG机器人的token密钥?#

    1.
    打开 Telegram,然后点击 @BotFather
    2.
    进入到机器人创建界面,点击开始Start,然后创建一个新的tg机器人
    3.
    根据提示给机器人取名并且选择设置一个用户名(需要用没被注册过的用户名)
    4.
    创建成功后BotFather会发送一个bot token给你,直接复制粘贴到openclaw这里即可
    image.png
    image.png

    OpenClaw 接入飞书完整指南#

    安全与风险提示(使用前必读)
    核心风险:此插件通过飞书接口连接了你的工作数据——消息、文档、日历、联系人,AI 能读到的东西理论上就有泄露的可能。
    强烈建议:先用个人账号安全地"玩"起来,等后续安全隔离能力更成熟了,再考虑接入真实工作环境。
    操作风险:AI 代发的飞书消息以您的名义发出,发出后即成事实。对于涉及发送、修改、写入等重要操作,务必做到"先预览,再确认"。

    飞书官方插件 vs 手动配置#

    方式优点适用场景
    飞书官方插件(推荐)一键安装、权限完整、持续维护新用户首选,功能最全
    手动创建应用权限可精细控制有特殊权限需求时
    💡
    飞书官方插件最新版本:2026.3.31,每天持续迭代更新。
    版本要求:Linux/MacOS 需 OpenClaw ≥ 2026.2.26;Windows 需 OpenClaw ≥ 2026.3.2

    方式一:使用飞书官方插件(推荐)#

    步骤一:确认 OpenClaw 已安装并配置好模型#

    确认 OpenClaw 正常运行:
    如果版本低于要求,先升级:

    步骤二:安装飞书官方插件#

    在终端执行:
    如果执行出错,可在命令前加 sudo 重新执行(Linux/Mac)
    安装过程中可选择:
    新建机器人:扫描二维码,选择一键创建飞书机器人
    关联已有机器人:输入已有应用的 App ID 和 App Secret
    💡
    Windows 扫码失败? 可能是终端分辨率问题,建议更换终端,推荐使用 Cmder

    步骤三:完成用户授权#

    机器人创建成功后,在飞书对话框中发送:
    /feishu auth
    这会批量完成用户授权,让 OpenClaw 可以以你的身份操作消息、文档、多维表格、日历等。

    步骤四:验证安装#

    在飞书对话中发送:
    /feishu start
    若返回版本号信息,则代表安装成功。
    让 OpenClaw 学习新插件能力:
    学习一下我安装的新飞书插件,列出有哪些能力。

    如何更新飞书插件到最新版本#


    方式二:手动创建飞书应用#

    第一步:创建飞书应用#

    登录飞书开放平台,点击创建企业自建应用
    image.png
    填写应用名称(如 "OpenClaw助手")、应用描述,选择应用图标,点击创建按钮,进入应用管理页面。
    image.png
    添加应用能力机器人
    提示:添加机器人之后,可以暂不发布,待其他配置完成后一并发布。
    复制AppID和AppSecret
    image.png

    第二步:配置事件与权限#

    点击事件与回调,设置事件配置订阅方式为长连接,同时添加接收消息事件,回调设置订阅方式也为长连接,不需要添加回调
    image.png
    image.png

    第三步:配置权限#

    点击"开发配置 > 权限管理",点击"批量导入/导出权限"按钮,在"导入"页签中粘贴以下完整权限 JSON:
    {
      "scopes": {
        "tenant": [
          "contact:contact.base:readonly",
          "docx:document:readonly",
          "im:chat:read",
          "im:chat:update",
          "im:message.group_at_msg:readonly",
          "im:message.p2p_msg:readonly",
          "im:message.pins:read",
          "im:message.pins:write_only",
          "im:message.reactions:read",
          "im:message.reactions:write_only",
          "im:message:readonly",
          "im:message:recall",
          "im:message:send_as_bot",
          "im:message:send_multi_users",
          "im:message:send_sys_msg",
          "im:message:update",
          "im:resource",
          "application:application:self_manage",
          "cardkit:card:write",
          "cardkit:card:read",
          "drive:drive.metadata:readonly",
          "docs:document.comment:create",
          "docs:document.comment:delete",
          "docs:document.comment:read",
          "docs:document.comment:update",
          "docs:document.comment:write_only",
          "docx:document:create",
          "docx:document:readonly",
          "docx:document:write_only",
          "docx:document.block:convert"
        ],
        "user": [
          "contact:user.employee_id:readonly",
          "offline_access",
          "base:app:copy",
          "base:field:create",
          "base:field:delete",
          "base:field:read",
          "base:field:update",
          "base:record:create",
          "base:record:delete",
          "base:record:retrieve",
          "base:record:update",
          "base:table:create",
          "base:table:read",
          "base:table:update",
          "base:view:read",
          "base:view:write_only",
          "base:app:create",
          "base:app:update",
          "base:app:read",
          "sheets:spreadsheet.meta:read",
          "sheets:spreadsheet:read",
          "sheets:spreadsheet:create",
          "sheets:spreadsheet:write_only",
          "docs:document:export",
          "docs:document.media:upload",
          "board:whiteboard:node:create",
          "board:whiteboard:node:read",
          "calendar:calendar:read",
          "calendar:calendar.event:create",
          "calendar:calendar.event:read",
          "calendar:calendar.event:reply",
          "calendar:calendar.event:update",
          "calendar:calendar.free_busy:read",
          "contact:contact.base:readonly",
          "contact:user.base:readonly"
        ]
      }
    }
    点击下一步,确认新增权限,继续申请开通,等待权限导入完成。
    image.png

    第四步:发布机器人#

    权限管理设置完成后,创建一个新版本并发布。发布成功后,飞书客户端会收到提示,配对机器人。
    image.png
    image.png
    随便给机器人发个消息,会回复配对码,输入给 openclaw 即可完成配对。

    飞书插件高级配置#

    开启流式输出#

    让 OpenClaw 在飞书中像打字机一样逐步输出回复(推荐开启):
    开启流式输出后,还可以在卡片底部显示耗时和状态:

    开启多任务并行(话题独立上下文)#

    让机器人在话题群/消息群话题模式中,每个话题拥有独立上下文,支持多任务并行:

    群组回复模式配置#

    模式 1:仅响应应用所有者的消息(推荐,3.17+ 默认)#

    机器人只响应应用所有者(主人)@ 机器人的消息,忽略其他人。
    {
      "channels": {
        "feishu": {
          "enabled": true,
          "appId": "cli_你的AppID",
          "appSecret": "你的AppSecret",
          "requireMention": true,
          "groupPolicy": "allowlist",
          "groupAllowFrom": ["ou_你的openid"],
          "groups": { "*": { "enabled": true } }
        }
      }
    }
    如何获取自己的 openid?直接问 OpenClaw:"你好,我的 openid 是多少?"

    模式 2:@ 机器人才回复,响应群内任何人#

    完整配置示例:
    {
      "channels": {
        "feishu": {
          "enabled": true,
          "appId": "cli_你的AppID",
          "appSecret": "你的AppSecret",
          "requireMention": true,
          "groupPolicy": "open"
        }
      }
    }

    模式 3:不用 @,所有消息都回复#

    :::highlight red ⚠️
    此模式在大群里容易刷屏,谨慎使用!需要额外申请权限:im:message.group_msg
    :::
    完整配置示例:
    {
      "channels": {
        "feishu": {
          "enabled": true,
          "appId": "cli_你的AppID",
          "appSecret": "你的AppSecret",
          "requireMention": false,
          "groupPolicy": "open"
        }
      }
    }

    模式 4:按群设置不同规则(高级)#

    不同群采用不同策略,例如工作群严格要求 @,闲聊群随意:
    完整配置示例:
    {
      "channels": {
        "feishu": {
          "enabled": true,
          "appId": "cli_你的AppID",
          "appSecret": "你的AppSecret",
          "requireMention": "open",
          "groupPolicy": "open",
          "groups": {
            "oc_你的群ID_1": { "requireMention": true },
            "oc_你的群ID_2": { "requireMention": true }
          }
        }
      }
    }
    如何获取群 ID?让机器人加入群后发送任意消息,然后在日志里找,或直接让机器人回复群 ID。

    常见问题诊断#

    在飞书对话中发送以下指令自检:
    指令说明
    /feishu start确认是否安装成功,返回版本号
    /feishu doctor检查配置是否正常
    /feishu auth批量完成用户授权
    在终端运行诊断工具:

    云服务器配置添加自定义模型#

    image.png
    Claude 模型,使用"Anthropic"协议,以 claude-opus-4-6 为例:
    {
      "provider": "xinghu",
      "base_url": "https://xinghuapi.com/v1",
      "api": "anthropic-messages",
      "api_key": "your-api-key-here",
      "model": {
        "id": "claude-opus-4-6",
        "name": "claude-opus-4-6"
      }
    }
    ChatGPT 模型,使用"OpenAI"协议,以 gpt-5.3-codex 为例:
    {
      "provider": "xinghu",
      "base_url": "https://xinghuapi.com/v1",
      "api": "openai-completions",
      "api_key": "your-api-key-here",
      "model": {
        "id": "gpt-5.3-codex",
        "name": "gpt-5.3-codex"
      }
    }

    实用资源#

    官方资源#

    资源链接
    OpenClaw 官方文档https://docs.openclaw.ai
    Skills 广场(500+ 扩展技能)https://clawhub.ai

    腾讯云 · 部署教程#

    教程图文视频
    🔥 一键秒级部署指南(新手必看)图文视频
    AI 对话式部署(适合存量服务器)图文—

    腾讯云 · 接入各平台聊天工具#

    平台图文教程视频教程
    💬 微信接入微信—
    💬 微信小程序接入微信小程序—
    💬 企业微信应用接入微信教程—
    🐧 QQ接入 QQ视频
    💼 企业微信接入企业微信视频
    🔶 飞书 / Lark接入飞书视频
    📌 钉钉接入钉钉视频
    💎 腾讯元宝接入元宝—
    🤖 腾讯云 ADP 智能体平台接入 ADP—
    ✈️ Telegram接入 Telegram—
    🎮 Discord接入 Discord—
    📱 WhatsApp接入 WhatsApp—
    💬 Slack接入 Slack—
    🟢 LINE接入 LINE—
    🍎 iMessage接入 iMessage—

    腾讯云 · 实用配置与进阶#

    主题链接
    OpenClaw 疑难杂症 FAQ 一览https://cloud.tencent.com/developer/article/2636212
    如何更新 OpenClaw 版本https://cloud.tencent.com/developer/article/2627964
    配置多个相互独立的 Agenthttps://cloud.tencent.com/developer/article/2632835
    配置自定义模型(OpenAI / Gemini 等)https://cloud.tencent.com/developer/article/2625144
    各大模型 API 免费额度介绍https://cloud.tencent.com/developer/article/2626756
    降低 Token 消耗技巧https://cloud.tencent.com/developer/article/2634542
    如何访问 OpenClaw WebUI Dashboardhttps://cloud.tencent.com/developer/article/2627309
    数据持久存储指南https://cloud.tencent.com/developer/article/2626165
    云服务器安全加固指南https://cloud.tencent.com/developer/article/2627780
    全链路防护与安全框架https://cloud.tencent.com/developer/article/2636372

    腾讯云 · Skills 与使用案例#

    主题链接
    OpenClaw Skills 安装与使用指南https://cloud.tencent.com/developer/article/2627350
    6 个超实用 Skills 让 OpenClaw 超进化https://cloud.tencent.com/developer/article/2627617
    5 分钟让 OpenClaw 玩转飞书全家桶https://cloud.tencent.com/developer/article/2631667
    10 分钟打造 AI 自动选股系统https://cloud.tencent.com/developer/article/2631336
    零门槛打通 iCloud 核心应用https://cloud.tencent.com/developer/article/2638599
    手把手配置腾讯文档 Skillhttps://cloud.tencent.com/developer/article/2636993
    修改于 2026-04-18 03:15:57
    上一页
    如何使用星狐云API?
    下一页
    HermesAgent配置星狐云 API 使用教程
    Built with