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

m0_65682055

135人浏览 · 2026-07-28 23:50:31

m0_65682055 · 2026-07-28 23:50:31 发布

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	官方 API
网络访问	国内直连,无需代理	需要科学上网
支付方式	支持支付宝/微信	需要海外信用卡
模型覆盖	聚合多家主流模型	单一厂商模型
调用成本	相对较低	官方定价

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

三、前置准备

3.1 确认已安装 OpenClaw

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

3.2 获取 API 密钥

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

注册账号并登录
进入 令牌管理 页面
点击 创建新令牌
复制生成的 API Key(格式通常为 sk-xxxxxxxx)

⚠️ 安全提示: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
      }
    ]
  }
}

配置项说明:

字段	说明	示例值
`name`	提供商标识,自定义名称	`"moyu"`
`baseUrl`	API 服务地址	`"`https://api.lk888.ai`"`
`apiKey`	你的 API 密钥	`"sk-xxxxxxxx"`
`api`	API 格式类型	`"openai-completions"` (兼容 OpenAI)
`authHeader`	是否使用自定义认证头	`false`

4.3 添加模型定义

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

json

复制

模型配置项说明:

字段	说明
`id`	模型 ID,需与 API 服务支持的模型名称一致
`name`	显示名称,可自定义便于识别
`provider`	提供商名称,对应上面定义的 `moyu`
`api`	API 类型,使用 `openai-completions`
`reasoning`	是否为推理模型(如 o1/o3)
`input`	支持的输入类型(文本/图片/音频等)
`cost`	费用配置,可设为 0
`contextWindow`	上下文窗口大小(token 数)
`maxTokens`	最大输出 token 数

⚠️ 重要提示: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 无效或已过期。

解决方案:

检查 API Key 是否正确复制(注意前后空格)
登录平台控制台确认密钥状态
重新生成密钥并更新配置文件

8.2 报错:`404 Not Found`

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

解决方案:

查看平台文档确认支持的模型列表
检查 id 字段是否与平台命名一致
部分平台模型名称区分大小写

8.3 报错:`Network Error`

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

解决方案:

检查网络连接是否正常
确认 baseUrl 是否正确(包含 https://)
尝试在浏览器中访问该地址测试可达性

8.4 模型切换无效

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

解决方案:

保存配置文件后,必须重启 OpenClaw
某些版本支持热重载,可尝试执行 openclaw reload

8.5 上下文超出限制

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

解决方案:

查看模型文档确认实际上下文窗口大小
调整配置文件中的 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 选择合适的模型

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

任务类型	推荐模型	理由
简单问答	claude-sonnet-4-6	响应快,成本低
代码生成	deepseek-v3	专精代码,性价比高
复杂推理	gpt-4o / claude-opus-4-6	能力强,适合复杂任务
文档总结	gemini-3-pro	长上下文,适合处理大文档

10.2 合理设置 maxTokens

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

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

10.3 使用缓存机制

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

json

复制

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

十一、总结

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

前置准备 - 获取 API Key 和服务地址
提供商配置 - 添加 API 提供商信息
模型定义 - 配置可用模型列表
默认模型 - 设置主要使用的模型
验证配置 - 测试配置是否生效
高级配置 - Anthropic API、多模型、任务别名等
问题排查 - 常见错误及解决方案

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

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

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

https://edu.csdn.net/learn/39067/627173?utm_source=2019755004

汇聚全球AI编程工具，助力开发者即刻编程。

更多推荐

Codex 和 Claude Code 怎么订阅？套餐、API计费与付款避坑指南

AI编程社区

AI编程成本越来越高，tokens越充越少，怎么降成本？

AI编程社区

AI编程模型横评2026：Claude Code vs Cursor vs Codex，Agent化编程正在杀死补全模式

AI编程社区

所有评论(0)

查看更多评论

m0_65682055

@m0_65682055

已为社区贡献7条内容

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

m0_65682055

一、OpenClaw 简介

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

三、前置准备

3.1 确认已安装 OpenClaw

3.2 获取 API 密钥

3.3 记录服务地址

四、配置 OpenClaw

4.1 定位配置文件

4.2 添加提供商配置

4.3 添加模型定义

4.4 配置默认模型

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

五、完整配置示例

六、验证配置

6.1 重启 OpenClaw

6.2 查看启动日志

6.3 测试对话

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

7.1 为什么需要单独配置

7.2 添加 Anthropic 提供商

7.3 添加 Claude 模型

7.4 同时使用多个提供商

八、常见问题排查

8.1 报错:401 Unauthorized

8.2 报错:404 Not Found

8.3 报错:Network Error

8.4 模型切换无效

8.5 上下文超出限制

九、进阶配置

9.1 添加多个模型

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

9.3 配置请求超时时间

十、成本优化建议

10.1 选择合适的模型

10.2 合理设置 maxTokens

10.3 使用缓存机制

十一、总结

所有评论(0)

温馨提示：您尚未绑定手机号

m0_65682055

8.1 报错:`401 Unauthorized`

8.2 报错:`404 Not Found`

8.3 报错:`Network Error`