OpenClaw 接入

OpenClaw 是本地或远程部署的智能体网关。官方说明见 OpenClaw 中文文档。

1. 安装并检查版本

只从 OpenClaw 官方域名运行安装脚本：

# macOS / Linux
curl -fsSL https://openclaw.ai/install.sh | bash
openclaw --version

Windows PowerShell：

iwr -useb https://openclaw.ai/install.ps1 | iex
openclaw --version

远程脚本会执行安装操作；运行前确认地址仍为官方域名。无法确认时，按官方文档选择手动安装。

2. 完成初始向导

openclaw onboard
openclaw gateway

首次使用可以选择 QuickStart，暂时跳过不需要的聊天渠道和 Skills，先完成本地模型验证。

3. 找到配置文件

• macOS/Linux：~/.openclaw/openclaw.json
• Windows：C:\Users\你的用户名\.openclaw\openclaw.json

编辑前先备份原文件。下面只展示模型相关结构，应合并到现有配置，不要覆盖已有渠道和工作目录。

4. 配置 Lunora Responses Provider

把两处“控制台模型 ID”替换成相同的当前可用模型：

{
  "models": {
    "mode": "merge",
    "providers": {
      "lunora": {
        "baseUrl": "https://api.uselunora.com/v1",
        "apiKey": "你的 Lunora API Key",
        "auth": "api-key",
        "api": "openai-responses",
        "authHeader": true,
        "models": [
          {
            "id": "控制台模型 ID",
            "name": "控制台模型 ID",
            "reasoning": true,
            "input": ["text", "image"]
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "lunora/控制台模型 ID"
      },
      "models": {
        "lunora/控制台模型 ID": {
          "alias": "Lunora"
        }
      },
      "workspace": "/你的/OpenClaw/工作目录",
      "compaction": {
        "mode": "safeguard"
      },
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      }
    }
  }
}

Windows 的 workspace 可以写成 C:\\Users\\你的用户名\\.openclaw\\workspace。配置文件包含明文 Key，应限制文件权限并避免上传。

5. 可选：配置 Telegram

{
  "channels": {
    "telegram": {
      "enabled": true,
      "dmPolicy": "pairing",
      "botToken": "你的 Telegram Bot Token",
      "groupPolicy": "allowlist",
      "streaming": "partial",
      "streamMode": "partial"
    }
  }
}

Bot Token 与 API Key 同样敏感，不要公开。其他聊天渠道按 OpenClaw 官方文档配置。

6. 重启并验证

openclaw gateway restart

先在专门的测试工作目录中发送简短任务，确认模型、工具权限和用量记录正常，再连接正式项目或聊天渠道。

常见问题

配置文件启动失败

先检查 JSON 逗号、括号和转义字符，再确认你是合并配置而不是把示例覆盖到整个文件。

模型不存在

models[].id、agents.defaults.model.primary 和 agents.defaults.models 三处模型 ID 必须一致，并与控制台当前名称相同。