OpenClaw 接入教程

开源 AI 代理框架 — 让 AI 在你的终端持续运行、自动执行任务。

你需要准备：
1. 1xAPI 账号 + API Key
2. Node.js 22+
3. OpenClaw：github.com/openclaw/openclaw

1. 安装 OpenClaw

bash

# 全局安装
npm install -g openclaw

# 验证
openclaw --version

2. 初始化

bash

# 创建工作目录并初始化
mkdir my-agent && cd my-agent
openclaw init

3. 配置 1xAPI

编辑 openclaw.json（或 ~/.openclaw/openclaw.json），添加 provider：

json

{
  "providers": {
    "1xapi": {
      "api": "anthropic-messages",
      "baseUrl": "https://api.1xapi.cc",
      "apiKey": "你的1xAPI-Key"
    }
  },
  "defaultModel": "1xapi/claude-sonnet-4-6"
}

apiKey 不要提交到 Git。建议使用环境变量："apiKey": "${ONEXAPI_KEY}"

使用环境变量（推荐）

bash

# 在 ~/.bashrc 或 ~/.zshrc 中添加
export ONEXAPI_KEY="你的1xAPI-Key"

然后在 openclaw.json 中引用：

json

{
  "providers": {
    "1xapi": {
      "api": "anthropic-messages",
      "baseUrl": "https://api.1xapi.cc",
      "apiKey": "${ONEXAPI_KEY}"
    }
  }
}

4. 可用模型

配置好 provider 后，可以使用以下模型名称：

1xapi/claude-opus-4-6 — 最强推理能力
1xapi/claude-sonnet-4-6 — 性价比之选
1xapi/claude-haiku-4-5 — 最快速度
1xapi/claude-opus-4-6-1m — 最强推理 + 1M 上下文
1xapi/claude-sonnet-4-6-1m — 性价比 + 1M 上下文

5. 启动

bash

# 启动 OpenClaw
openclaw gateway start

# 确认状态
openclaw status

同时使用 GPT 模型

1xAPI 同时支持 OpenAI 格式，可以添加第二个 provider：

json

{
  "providers": {
    "1xapi-claude": {
      "api": "anthropic-messages",
      "baseUrl": "https://api.1xapi.cc",
      "apiKey": "${ONEXAPI_KEY}"
    },
    "1xapi-gpt": {
      "api": "openai",
      "baseUrl": "https://api.1xapi.cc/v1",
      "apiKey": "${ONEXAPI_KEY}"
    }
  }
}

这样就可以在同一个 OpenClaw 实例中切换 Claude 和 GPT 模型。

常见问题

连接超时

确认 baseUrl 正确（Anthropic 格式不加 /v1）
确认 API Key 有效
确认网络能访问 api.1xapi.cc

模型名称错误

使用 provider名/模型名 格式，如 1xapi/claude-sonnet-4-6。模型名需要跟 Anthropic 官方 model ID 一致。