OpenClaw 配置

OpenClaw 这类 Agent 工具通常会提供自定义模型服务商或 OpenAI-compatible provider 配置。只要工具允许填写 Base URL、API Key 和模型 ID,就可以按 OpenAI 兼容方式接入 Modelink。

信息

不同版本的 OpenClaw 配置文件路径和字段名可能不同。以下内容以“支持自定义 OpenAI 兼容 provider”为前提,具体字段以工具当前版本说明为准。

基础配置

配置项建议值
ProviderModelink
Provider Typeopenai-compatibleopenai
Base URL中国大陆 https://api.qnaigc.com/v1,海外 https://api.modelink.ai/v1
API KeyModelink API Key
Model控制台中的模型 ID

配置前检查

OpenClaw 的不同版本或分支可能使用不同配置方式。写入任何配置前,先在当前版本文档或工具内设置界面确认:

  • 是否支持自定义 OpenAI-compatible provider。
  • Base URL 字段是否要求包含 /v1
  • API Key 是写入系统密钥链、环境变量,还是本地配置文件。
  • 模型 ID 是否可以手动填写。
  • 工具调用、文件写入、命令执行权限如何配置。

如果当前版本没有明确的自定义 provider 配置项,不要强行创建 providersdefaultProviderbaseUrl 等字段;这些字段名未必会被工具读取。

Agent 权限建议

OpenClaw 这类工具通常具备文件读取、代码修改、命令执行或浏览器操作能力。接入 Modelink 后,仍应重点治理工具权限:

  • 默认从只读模式或低风险目录开始。
  • .env、密钥、生产配置、客户数据目录设置拒绝读取。
  • 写文件、运行命令、安装依赖、推送代码前要求人工确认。
  • 记录关键操作、模型、耗时、错误和请求 ID。
  • 团队协作时使用独立 API Key,便于追踪用量和撤销权限。

验证与排障

  • 先让工具执行“解释当前项目结构”这类只读任务。
  • 如果提示 401 / 403,检查 API Key 和账号权限。
  • 如果提示模型不存在,确认模型 ID 是否与 Modelink 控制台一致。
  • 如果请求路径错误,确认 Base URL 是否包含 /v1
  • 如果工具调用失败,确认当前模型和 OpenClaw 版本是否支持 tool calling。

参考