Roo Code 兼容 API 接入：原生工具调用是前提
根据 Roo Code 官方 OpenAI Compatible 文档配置地址与模型，重点核对原生工具调用、流式工具事件和模型元数据，说明失败时的停手条件。
内容复核中 官方配置已核对；本站接入未实测。 图解为本站原创示意，不是客户端运行截图。
查看教程占位服务地址
- 控制台
https://80321.cn- 创建 Key
https://80321.cn/keys- 钱包充值
https://80321.cn/wallet- 文档站
https://80321.cn/docs.html
以上服务地址仅为教程占位示例，不代表本站已提供控制台、密钥创建、充值或 API 服务。实际接入地址请以正式提供的配置为准。
本页目录
Roo Code 的兼容服务接入不能只检查模型会不会聊天。当前读到的官方文档要求原生工具调用，并明确没有 XML 工具调用回退。因此只提供普通文本补全的模型，不适合作为这条 Agent 接入路径。
先确认服务的 tools 契约
官方说明客户端以原生 tools 结构发送工具定义，模型通过专门的工具事件返回名称、参数及元数据，参数可以增量流式传回。兼容服务若只支持部分工具字段，仍可能导致 Agent 任务失败；不能靠输出一段看似工具指令的文字替代。
接入前应向服务方确认目标模型支持工具调用、工具参数流式传输和工具结果回传。回答“兼容 OpenAI”不足以替代这份具体能力说明。
设置面板选择 OpenAI Compatible
在 Roo Code 面板打开设置，将 API Provider 选为 OpenAI Compatible，填写服务根地址、密钥，并选择服务提供的模型。此入口与官方 OpenAI 供应商入口应分开理解。
API Provider: OpenAI Compatible
Base URL: https://80321.cn/v1
API Key: YOUR_API_KEY
Model: YOUR_MODEL_ID以上均为占位，本站没有提供展示的真实接口。这是面板填值示例，不是 VS Code 通用配置文件；不要据此在其他设置里猜测同名字段。
模型配置只描述已确认能力
官方允许设置最大输出、上下文窗口、图片、Computer Use 以及输入输出价格。 应按真实模型和服务契约填写，而不是照搬其他供应商的参数。只有文本任务时，先不启用图片或计算机操作，避免扩大验证范围。
不知道上下文上限时先向服务方确认，不把高数值当成解决截断的通用办法。用量或价格显示也只辅助评估，不能据此作出结算承诺。
最小任务必须包含一次工具往返
在无秘密的测试工作区里，先让模型回答一个短问题，再让它读取一份小型说明文件并总结。保留审批，检查任务时间线中是否出现原生工具调用事件、对应结果以及最终回答。
验收时分别记录文本链路和工具链路。如果只是收到回答，没有真实工具事件，就不要标记 Agent 已可用。测试文件还应包含可核对的简单内容，防止模型在未读取时凭空总结。
何时停止，而不是改审批
官方建议鉴权错误查 Key，模型不存在查 ID，连接错误查地址与可达性；工具调用错误则必须核对原生工具支持，必要时更换符合条件的模型。 不通过打开自动执行、编造旧式 XML 回退或关闭证书校验来继续任务。
本轮原官方地址跳转到了官方 GitHub Pages 文档，页面版本可能与已安装扩展不同。配置前先核对本地版本对应说明；本文未运行 Roo Code，也没有验证本站接口或承诺所有模型可用。