All ClawAll Claw
Back to Blog
BlogMarch 13, 2026

OpenClaw 将 OpenRouter Auto 改为具体模型完整教程

OpenClaw 将 OpenRouter Auto 改为具体模型完整教程

Prerequisites

  • OpenClaw 已成功安装并运行（通过 curl -fsSL https://get.openclaw.ai | bash 或 GitHub 源码安装）
  • 已注册 OpenRouter 并生成 API Key
  • OPENROUTER_API_KEY 已添加到环境变量（export OPENROUTER_API_KEY=sk-or-...）或 ~/.openclaw/openclaw.json 的 auth 部分
  • 基本终端操作能力（编辑 JSON、运行命令）

强烈建议先备份：

cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak

Step 1: 验证当前模型配置

运行以下命令检查当前使用的模型：

openclaw status
openclaw doctor

预期输出中会显示类似 agent model: openrouter/openrouter/auto。如果未安装 CLI 工具，先运行 openclaw 确保 Gateway 正常。

Step 2: 使用 CLI 一键切换（推荐，最简单）

OpenClaw 内置 models set 命令可直接修改默认模型：

# 改为 Claude Sonnet 系列（示例）
openclaw models set openrouter/anthropic/claude-sonnet-4-5

# 改为 Gemini Flash（快速且便宜）
openclaw models set openrouter/google/gemini-2.0-flash-exp

# 改为 Llama 系列
openclaw models set openrouter/meta-llama/llama-3.3-70b-instruct

查看可用模型列表（包含 OpenRouter 前缀）：

openclaw models list | grep openrouter

执行后会自动更新 openclaw.json 中的 agents.defaults.model.primary 并提示重启。

Step 3: 手动编辑配置文件（适用于高级自定义）

打开配置文件：

vim ~/.openclaw/openclaw.json

找到或添加以下结构（替换 primary 值）：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "minimax/minimax-m2.5"
      },
      "models": {
        "minimax/minimax-m2.5": {
          "alias": "OpenRouter"
        }
      }
    }
  }
}

获取精确模型 ID：访问 OpenRouter Models，复制对应模型的 OpenClaw 格式（通常为 openrouter/提供商/模型名）。

保存后重启服务：

openclaw gateway restart

这里要注意下不是 openclaw restart。

Step 4: 验证修改生效

运行测试命令：

openclaw status

或直接发起对话，输入 当前使用的模型是什么？ 让 AI 回答确认。

预期日志：agent model: openrouter/anthropic/claude-sonnet-4-5

Common Issues & Troubleshooting

  • 修改后仍显示 auto：重启 Gateway（openclaw restart 或 pkill -f openclaw 后重新启动）。部分版本需删除缓存：rm -rf ~/.openclaw/cache
  • Unknown model 错误：模型 ID 不正确。去 OpenRouter 官网确认最新 ID（如 :free 后缀用于免费模型）。
  • 无回复或速率限制：添加 fallbacks，或检查 API Key 额度。运行 openclaw doctor 查看详细诊断。
  • auth 未配置：确保 auth.profiles.openrouter:default 存在，或直接用环境变量。
  • 升级后配置丢失：这是已知 issue，重新执行 openclaw models set 或手动合并备份文件。

Next Steps

  • 进阶路由：配置 imageModel、reasoningModel 分任务使用不同模型，提升效率。
  • 多模型切换：结合 Skill（如 Claw Switch）用自然语言命令切换模型。
  • 成本优化：优先用 :free 模型 + Auto 作为 fallback。
  • 探索更多：运行 openclaw models list 发现 100+ 模型，或查看官方文档了解多 Agent 配置。

现在你的 OpenClaw 已使用指定模型，性能更稳定、输出更可控！

Share this article
XFacebookLinkedInRedditHacker News