OpenClaw 配置指南

OpenClaw 是一款本地 AI Agent 客户端，支持连接 WhatsApp、Telegram、Discord 等多个平台。通过配置自定义 Provider，可接入 Inkess 平台上的所有模型。

配置步骤

第一步：找到配置文件

OpenClaw 的配置文件位于：

~/.openclaw/openclaw.json

如果文件不存在，先启动一次 OpenClaw Gateway 自动生成。

第二步：添加 Inkess Provider

编辑 openclaw.json，在 models.providers 中添加 Inkess 配置：

推荐：Anthropic 原生协议（支持完整 Claude 功能，含扩展思考、工具调用）

{
  "models": {
    "mode": "merge",
    "providers": {
      "inkess": {
        "baseUrl": "https://llm.starapp.net/api/llm",
        "apiKey": "your-token-here",
        "api": "anthropic-messages",
        "models": [
          { "id": "claude-sonnet-4-5", "name": "Claude Sonnet 4.5" },
          { "id": "claude-haiku-4-5", "name": "Claude Haiku 4.5" }
        ]
      }
    }
  }
}

备选：OpenAI 兼容协议

{
  "models": {
    "mode": "merge",
    "providers": {
      "inkess": {
        "baseUrl": "https://llm.starapp.net/api/llm/v1",
        "apiKey": "your-token-here",
        "api": "openai-responses",
        "models": [
          { "id": "claude-sonnet-4-5", "name": "Claude Sonnet 4.5" },
          { "id": "deepseek-chat", "name": "DeepSeek Chat" }
        ]
      }
    }
  }
}

将 your-token-here 替换为您在控制台令牌页创建的 Token（ik-...）。

第三步：设置默认模型（可选）

在 agents.defaults 中指定默认使用的模型：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "inkess/claude-sonnet-4-5"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "inkess": { ... }
    }
  }
}

第四步：重启 Gateway

修改配置后重启 OpenClaw Gateway 使配置生效：

openclaw gateway restart

或在应用内重启 Gateway 服务。

第五步：验证配置

在 OpenClaw 中运行：

/models

看到 inkess/claude-sonnet-4-5 等模型出现在列表中即配置成功。

注意事项

• Anthropic 原生协议 baseUrl 为 https://llm.starapp.net/api/llm（不含 /v1）
• OpenAI 兼容协议 baseUrl 为 https://llm.starapp.net/api/llm/v1（含 /v1）
• 模型 ID 需从控制台模型列表页复制，注意大小写

常见问题

Gateway 启动失败：运行 openclaw doctor 检查配置文件语法错误（JSON 格式不合法会阻止启动）。

模型列表为空：确认 models.mode 设置为 "merge" 而非 "override"，否则会覆盖内置模型。

401 Unauthorized：Token 无效，在控制台令牌页确认 Token 状态正常且未被禁用。