玄枢API玄枢API

玄枢API

OpenClaw 接入教程

把 OpenClaw 接到玄枢API，可选 Anthropic（Claude）或 OpenAI（Codex）通道，含一键脚本、手动安装、配置、最小测试、回滚与排错。

1. 准备 API Key

  1. 还没有账户的先到 /register 注册。
  2. 在 /keys 创建一个供 OpenClaw 单独使用的 Key，按需要设置额度、有效期和访问限制。
  3. 立即安全保存完整 Key；页面再次打开时可能只显示脱敏值。不要写入仓库、截图或聊天记录。

2. 一键安装（推荐）

运行后按提示选择通道并粘贴 API Key，脚本会写入 ~/.openclaw/config.yml。脚本需要 sudo，且只写配置、不会自动安装 OpenClaw。源码见 /install/openclaw.sh。

curl -fsSL https://www.xuanshuapi.com/install/openclaw.sh | sudo bash
安装 OpenClaw（一键脚本不会自动安装）一键脚本只写配置，运行前必须先完成这一步

3. 手动安装

  1. 用 npm 安装：
    npm install -g openclaw
openclaw --version
  2. npm 包名是 openclaw；@openclaw/cli 不存在。
  3. 看到版本号即安装成功。

4. 选择通道并写入配置

模型会更新，当前可用列表以 /available-channels 为准。已有配置会被覆盖，建议先备份。

export ANTHROPIC_API_KEY="<YOUR_API_KEY>"
openclaw onboard --auth-choice custom-api-key \
  --custom-base-url https://www.xuanshuapi.com \
  --custom-api-key-env ANTHROPIC_API_KEY \
  --custom-compatibility anthropic \
  --custom-model claude-opus-4-6

5. 运行最小测试

在项目目录执行下面的命令启动 OpenClaw，随便问一句话，确认能拿到回复。

openclaw

6. 成功标准

OpenClaw 正常启动并返回模型回复；在 /usage 能看到对应模型的成功调用记录，且没有 404、401/403 或 429。三点都满足再进入真实项目。

7. 回滚配置

备份配置文件并清除当前终端里的相关环境变量，然后开启新的登录 Shell。

mv ~/.openclaw/config.yml ~/.openclaw/config.yml.xuanshu-backup
unset ANTHROPIC_API_KEY ANTHROPIC_BASE_URL \
  OPENAI_API_KEY OPENAI_BASE_URL
exec "$SHELL" -l

8. 常见问题排查

先记录状态码、请求时间、模型 ID 和 /usage 里的调用记录；分享日志时隐藏完整 Key。

现象检查处理
404Anthropic 通道的 --custom-base-url 必须是 https://www.xuanshuapi.com（不带 /v1）；Codex 通道必须带 /v1。按通道改正 --custom-base-url，重新运行 onboard 后重试。
401 / 403确认环境变量里的 Key 是完整未截断的值，且该 Key 未过期、未被吊销。在 /keys 重新复制或新建 Key，重新导出环境变量。
模型不可用用同一个 Key 在 /available-channels 核对精确模型 ID 与当前可见性。改 --custom-model 重新 onboard；模型暂不可用时改用同协议的可用模型。
429在 /usage 检查余额、Key 限额和并发请求数。降低并发并等待限流窗口恢复，只对 429 使用有上限的退避重试。
配置未生效确认写入的是 ~/.openclaw/config.yml，且 OpenClaw 已重启。重启 OpenClaw；一键脚本写入后已打开的会话不会自动重载。
命令未找到openclaw 未安装或 npm 全局目录不在 PATH。先执行 npm install -g openclaw，再重开终端。