OpenClaw 接入 AI 模型完全指南 | 从零配置到实战应用

OpenClaw 是一款开源的 AI 代码助手工具,支持接入多种大模型 API。本文详细讲解如何将 OpenClaw 配置为使用星途AI等国内API服务商,实现低成本、高效率的AI编程辅助。

一、OpenClaw 简介

OpenClaw 是一个基于配置文件的 AI 编程助手,其核心优势在于:

• 多模型支持 – 通过配置文件可以接入任何兼容 OpenAI 格式的 API
• 本地化部署 – 配置文件存储在本地,数据隐私可控
• 灵活切换 – 支持多个提供商和模型的快速切换
• 工作空间隔离 – 可为不同项目配置独立的模型策略

与 GitHub Copilot、Cursor 等商业产品相比,OpenClaw 的最大特点是配置透明和成本可控——你可以选择任何 API 提供商,而不必被锁定在某个平台的订阅服务上。

二、为什么选择星途AI作为API提供商

在配置 OpenClaw 时,选择合适的 API 提供商至关重要。星途AI (AI Model Hub ）是国内一家 API 聚合平台,具备以下特点:

本文以星途AI为例进行配置演示,其他兼容 OpenAI 格式的 API 提供商(如星途AI、OpenRouter等)配置方法类似。

三、前置准备

3.1 确认已安装 OpenClaw

首先确认你的系统中已安装 OpenClaw。如果尚未安装,请访问 OpenClaw 官方仓库 按照文档完成安装。

3.2 获取 API 密钥

访问星途AI控制台(或你选择的其他平台):

⚠️ 安全提示:API Key 相当于你的账户密码,请妥善保管,不要提交到公开代码仓库。

3.3 记录服务地址

星途AI的服务地址为:

https://xingtu.lk888.ai/

部分平台可能提供多个接入点,请以官方文档为准。

四、配置 OpenClaw

4.1 定位配置文件

OpenClaw 的配置文件位于:

Windows:

C:\\Users\\你的用户名\\.openclaw\\config.json

macOS/Linux:

~/.openclaw/config.json

用任意文本编辑器(如 VS Code、Notepad++)打开该文件。

4.2 添加提供商配置

在配置文件的 models.providers 部分添加星途AI提供商:

json

复制

{
"models": {
"providers": [
{
"name": "xingtu",
"baseUrl": "https://xingtu.lk888.ai",
"apiKey": "sk-你的密钥",
"api": "openai-completions",
"authHeader": false
}
]
}
}

配置项说明:

4.3 添加模型定义

在 models 数组中添加你要使用的模型:

json

复制

模型配置项说明:

⚠️ 重要提示:id 字段必须与 API 提供商支持的模型名称完全一致,否则会报 404 错误。不同平台的模型命名可能有差异,请参考平台文档。

4.4 配置默认模型

在 agents.defaults 部分配置主要使用的模型:

json

复制

{
"agents": {
"defaults": {
"model": {
"primary": "moyu/gpt-4o"
},
"models": {
"fast": "moyu/claude-sonnet-4-6",
"smart": "moyu/gpt-4o",
"coder": "moyu/gpt-4o"
}
}
}
}

配置说明:

• model.primary:默认主模型,格式为 提供商名称/模型ID
• models:模型别名配置,便于快速切换
  • fast:快速响应场景
  • smart:复杂推理场景
  • coder:代码生成场景

4.5 配置工作空间路径(可选)

如果你需要指定 OpenClaw 的工作目录:

Windows:

json

复制

{
"workspace": "C:\\\\Users\\\\你的用户名\\\\.openclaw\\\\workspace"
}

macOS/Linux:

json

复制

{
"workspace": "~/.openclaw/workspace"
}

也可以使用相对路径(推荐):

json

复制

{
"workspace": "./workspace"
}

五、完整配置示例

将以上配置整合后的完整示例:

json

复制

六、验证配置

6.1 重启 OpenClaw

配置修改后,需要重启 OpenClaw 服务使配置生效:

bash

复制

# 停止服务
openclaw stop

# 启动服务
openclaw start

6.2 查看启动日志

启动后,你应该看到类似以下的日志输出:

[INFO] Loading configuration from ~/.openclaw/config.json
[INFO] Provider 'moyu' registered: https://api.lk888.ai
[INFO] Model 'gpt-4o' available (provider: moyu)
[INFO] Model 'claude-sonnet-4-6' available (provider: moyu)
[INFO] Default model set to: moyu/gpt-4o
[INFO] OpenClaw ready

如果出现错误,请检查:

• API Key 是否正确复制(前后无空格)
• baseUrl 是否包含协议头 https://
• 模型 ID 是否与平台支持的名称一致

6.3 测试对话

在 OpenClaw 界面中输入测试消息:

你好,请介绍一下自己。

如果收到正常回复,说明配置成功。

七、配置 Claude 模型(Anthropic API 格式)

7.1 为什么需要单独配置

部分平台在提供 Claude 模型时,使用的是 Anthropic Messages API 格式,而不是 OpenAI 兼容格式。这两种格式的请求结构不同,需要分别配置。

7.2 添加 Anthropic 提供商

在 models.providers 中添加新的提供商配置:

json

复制

{
"name": "moyu-claude",
"baseUrl": "https://api.lk888.ai",
"apiKey": "sk-你的密钥",
"api": "anthropic-messages",
"authHeader": false
}

⚠️ 关键区别:

• api 字段改为 "anthropic-messages"
• baseUrl 不需要 /v1 后缀

7.3 添加 Claude 模型

json

复制

{
"id": "claude-opus-4-6",
"name": "Claude Opus 4.6",
"provider": "moyu-claude",
"api": "anthropic-messages",
"reasoning": false,
"input": ["text", "images"],
"cost": {
"input": 0,
"output": 0
},
"contextWindow": 200000,
"maxTokens": 8192
}

7.4 同时使用多个提供商

你可以在同一个配置文件中定义多个提供商:

json

复制

{
"providers": [
{
"name": "moyu-openai",
"baseUrl": "https://api.lk888.ai",
"apiKey": "sk-你的密钥",
"api": "openai-completions"
},
{
"name": "moyu-claude",
"baseUrl": "https://api.lk888.ai",
"apiKey": "sk-你的密钥",
"api": "anthropic-messages"
}
]
}

然后在模型定义中通过 provider 字段指定使用哪个提供商。

八、常见问题排查

8.1 报错:401 Unauthorized

原因:API Key 无效或已过期。

解决方案:

8.2 报错:404 Not Found

原因:模型 ID 不存在或拼写错误。

解决方案:

8.3 报错:Network Error

原因:无法连接到 API 服务。

解决方案:

8.4 模型切换无效

原因:配置文件未重新加载。

解决方案:

8.5 上下文超出限制

原因:contextWindow 配置值大于实际模型支持的上下文长度。

解决方案:

九、进阶配置

9.1 添加多个模型

如果你需要使用更多模型,只需在 models 数组中继续添加:

json

复制

9.2 为不同任务配置专用模型

根据任务类型选择最优模型:

json

复制

{
"agents": {
"defaults": {
"models": {
"fast": "moyu/claude-sonnet-4-6",
"smart": "moyu/gpt-4o",
"coder": "moyu/deepseek-v3",
"translator": "moyu/claude-opus-4-6"
}
}
}
}

在使用时可以通过别名快速切换:

@coder 帮我实现一个快速排序算法
@translator 将这段文字翻译成英文

9.3 配置请求超时时间

如果你的网络环境较慢或使用的模型响应较慢,可以调整超时时间:

json

复制

{
"network": {
"timeout": 60000,
"retries": 3
}
}

十、成本优化建议

10.1 选择合适的模型

不同任务对模型能力的要求不同,选择合适的模型可以显著降低成本:

10.2 合理设置 maxTokens

maxTokens 限制了单次响应的最大长度,设置过大会增加不必要的成本:

• 简单问答:512 – 1024
• 代码生成:2048 – 4096
• 文档生成:4096 – 8192

10.3 使用缓存机制

如果平台支持 prompt caching,可以启用缓存减少重复请求的成本:

json

复制

{
"cache": {
"enabled": true,
"ttl": 3600
}
}

十一、总结

本文详细介绍了如何配置 OpenClaw 接入星途AI等国内 API 平台:

OpenClaw 的配置文件结构清晰,通过合理配置可以实现:

• 多模型灵活切换
• 成本可控的 AI 编程辅助
• 本地化的隐私保护

对于需要在不同 API 平台之间切换的开发者,掌握这套配置方法可以快速适配任何兼容 OpenAI 格式的 API 服务。