OpenClaw 是开源 AI Agent 平台，支持 Telegram、Discord、Slack、Signal、iMessage、WhatsApp 等多个消息渠道。通过设置 OPENROUTER_API_KEY 并在 openclaw.json 中使用 openrouter/<author>/<slug> 格式的模型 ID，即可将 OpenClaw 接入 OpenRouter。推荐使用 openclaw onboard 向导一键配置；进阶用户可设置多模型 Fallback 链和 openrouter/auto 智能路由，按渠道分配不同模型以平衡成本与能力。

OpenClaw（前身为 Moltbot、Clawdbot）是一个开源 AI agent 平台，让 AI 对话能力覆盖 Telegram、Discord、Slack、Signal、iMessage、WhatsApp 等多个消息渠道，支持多 LLM Provider 切换。

快速配置（推荐：向导模式）

最简单的配置方式是使用内置的 onboard 向导：

openclaw onboard

向导会引导你完成：选择 OpenRouter 作为 Provider、输入 API key、选择首选模型、配置消息渠道。

快速一行命令（跳过向导）：

openclaw onboard --auth-choice apiKey --token-provider openrouter --token "$OPENROUTER_API_KEY"

此命令自动以推荐模型 openrouter/auto 完成配置。

手动配置

适合高级用户，新用户建议使用上面的向导模式。

第一步：获取 OpenRouter API Key

在 openrouter.ai/keys 创建 API key（以 sk-or-... 开头）。

第二步：设置 API Key

编辑 ~/.openclaw/openclaw.json：

{
  "env": {
    "OPENROUTER_API_KEY": "sk-or-..."
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "openrouter/anthropic/claude-sonnet-4.5"
      },
      "models": {
        "openrouter/anthropic/claude-sonnet-4.5": {}
      }
    }
  }
}

或通过环境变量设置：

export OPENROUTER_API_KEY="sk-or-..."

OpenClaw 内置 OpenRouter 支持，无需配置 models.providers，只需设置 API key 并使用 openrouter/<author>/<slug> 格式的模型 ID。

第三步：选择模型

常用模型 ID 格式（openrouter/<author>/<slug>）：

模型	ID
Claude Sonnet 4.5	openrouter/anthropic/claude-sonnet-4.5
Gemini Pro 1.5	openrouter/google/gemini-pro-1.5
DeepSeek Chat	openrouter/deepseek/deepseek-chat
Kimi K2.5	openrouter/moonshotai/kimi-k2.5
智能路由	openrouter/openrouter/auto

在 openrouter.ai/models 查看所有可用模型的完整 ID。

第四步：启动 OpenClaw

openclaw gateway run

多模型 Fallback

设置主备模型链，提高可用性：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "openrouter/anthropic/claude-sonnet-4.5",
        "fallbacks": [
          "openrouter/anthropic/claude-haiku-3.5"
        ]
      },
      "models": {
        "openrouter/anthropic/claude-sonnet-4.5": {},
        "openrouter/anthropic/claude-haiku-3.5": {}
      }
    }
  }
}

这在 OpenRouter Provider 级自动故障转移之上额外增加了一层模型级备份。

Auto Model 智能路由（省钱利器）

OpenClaw agents 执行多种任务，从简单的心跳检测到复杂的多轮对话。统一用强力模型会浪费成本。

openrouter/openrouter/auto 会根据 prompt 自动选择最具性价比的模型：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "openrouter/openrouter/auto",
        "fallbacks": ["openrouter/anthropic/claude-haiku-3.5"]
      },
      "models": {
        "openrouter/openrouter/auto": {},
        "openrouter/anthropic/claude-haiku-3.5": {}
      }
    }
  }
}

按渠道分配不同模型

对延迟敏感的 Telegram 用轻量模型，Discord 社区对话用能力更强的模型：

{
  "telegram": {
    "agents": {
      "defaults": {
        "model": {
          "primary": "openrouter/anthropic/claude-haiku-3.5"
        }
      }
    }
  },
  "discord": {
    "agents": {
      "defaults": {
        "model": {
          "primary": "openrouter/anthropic/claude-sonnet-4.5"
        }
      }
    }
  }
}

故障排除

错误	解决方法
"No API key found for provider 'openrouter'"	运行 openclaw onboard --auth-choice apiKey --token-provider openrouter --token "$OPENROUTER_API_KEY"
认证错误 (401/403)	在 openrouter.ai/keys 验证 key 有效性和积分余额
模型不工作	确认使用 openrouter/<author>/<slug> 格式，从 openrouter.ai/models 查找准确 ID

监控用量

访问 OpenRouter 活动面板，可实时查看所有 OpenClaw agents 的请求量、成本和 token 用量，支持按模型和时间范围筛选。

常见问题

Q: openrouter/openrouter/auto 和直接指定模型有什么区别？

A: auto 是 OpenRouter 的智能路由模型，会根据 prompt 的复杂度和长度自动选择最合适的模型，目标是在满足质量要求的前提下最小化成本。适合 OpenClaw 这类任务差异大的场景；如果需要确定性的模型行为（如内容审核），建议指定具体模型。

Q: 如何安全存储 API key，避免写入配置文件？

A: 使用 OpenClaw 的 auth profiles + 系统密钥链：在 openclaw.json 中配置 auth.profiles，然后运行 openclaw auth set openrouter:default --key "$OPENROUTER_API_KEY" 将 key 存入系统密钥链（Keychain/Credential Manager），避免明文写入配置文件。

Q: 多个消息渠道是否支持独立的模型配置？

A: 支持。在 openclaw.json 的顶层按渠道名（telegram、discord 等）分组配置，各渠道可有独立的 agents.defaults.model 设置，会覆盖全局默认值。