OpenClaw 接入

OpenClaw 是一个 MIT 协议的开源自托管 AI agent 网关——核心定位是"个人助理 + 多通道接入"（终端 TUI / Web Dashboard / Telegram / WhatsApp / Slack / Discord 等），底层模型走任意 OpenAI / Anthropic 协议兼容 endpoint。把 why01 配进去，OpenClaw 在所有渠道上的对话都会经由本站。

你需要 OpenClaw 当且仅当

• 想在 Telegram / Slack / Discord 等 IM 里直接和 LLM 聊天
• 想跑一个自托管的 Web Dashboard 给团队用
• 想把模型调用统一收口到一个网关上做日志 / 用量审计

如果你只是想在终端里用 AI 写代码，Claude Code / Codex / OpenCode 任一即可，不必装 OpenClaw。

前置条件

• Node.js 22.14+（推荐 24）：Windows / macOS / Linux 安装指南
• why01 API Key：创建 API Key

1. 安装

npm（推荐）

npm install -g openclaw@latest
openclaw onboard --install-daemon

pnpm

pnpm add -g openclaw@latest
openclaw onboard --install-daemon

Docker

# 详见官方文档 docs.openclaw.ai/start/getting-started
docker run -d --name openclaw ghcr.io/openclaw/openclaw:latest

onboard --install-daemon 会装系统级守护进程，OpenClaw 的 gateway 才能在后台常驻接受请求。

2. 配置 provider 指向 why01

OpenClaw 的 model provider 配置在 agent 数据目录的 models.json（具体路径首次 onboard 后控制台会打印）。

最小可用结构：

{
  "providers": {
    "why01-openai": {
      "type": "openai",
      "baseUrl": "https://s1.why01.top/v1",
      "apiKey": "{env:OPENAI_API_KEY}"
    },
    "why01-anthropic": {
      "type": "anthropic",
      "baseUrl": "https://s1.why01.top",
      "apiKey": "{env:ANTHROPIC_AUTH_TOKEN}"
    }
  },
  "defaults": {
    "provider": "why01-openai",
    "model": "gpt-5-mini"
  }
}

WARNING

• OpenClaw 不读 OPENAI_BASE_URL / ANTHROPIC_BASE_URL 环境变量，必须通过 models.json 显式配 baseUrl
• apiKey 用 {env:VAR_NAME} 占位符引用环境变量，避免明文写进配置文件
• baseUrl 末尾是否带 /v1：OpenAI type 带、Anthropic type 不带

具体的字段名以你装的 OpenClaw 版本的官方文档为准（docs.openclaw.ai/concepts/models）——本页给的是常见结构，新版本可能微调。

3. 设环境变量

macOS / Linux

export OPENAI_API_KEY=sk-你的why01-key
export ANTHROPIC_AUTH_TOKEN=sk-你的why01-key      # 同一个 Key
source ~/.zshrc

Windows PowerShell（永久）

[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "sk-你的why01-key", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "sk-你的why01-key", "User")

如果已经按 一键配置脚本 设过两个 Key，跳过这一步。

4. 启动 gateway 与对话

启动网关：

openclaw gateway --port 18789 --verbose

新开终端发对话：

openclaw agent --message "你好"

或者直接在 OpenClaw 自带的 Web Dashboard / TUI 里聊。

5. 验证走 why01

跑完一轮对话到 why01 控制台 → 日志 看最近几分钟有没有对应模型的调用——有 = 接通。

接 IM 通道（Telegram / Slack 等）

OpenClaw 的精髓是把同一个 agent 暴露到多个 IM 通道。每个通道的 token / webhook 配置在 channels.json，详见 docs.openclaw.ai。通道层和模型层解耦——配好 why01 一次，所有通道都走 why01。

常见问题

/model status 显示的 baseUrl 不对

models.json 改了之后需要 openclaw gateway 重启，进程不热加载配置。

启动报 401

• 检查 OPENAI_API_KEY / ANTHROPIC_AUTH_TOKEN 真的设进去了
• 检查 models.json 里 apiKey 是 {env:...} 占位符，不是直接写 sk-
• Key 未禁用未过期

调用模型 404

models.json 里 defaults.model 字段填的模型名按 控制台模型页 实际可用名填。

这不是官方支持的接入方式吗

OpenClaw 协议层和官方一致，本站作为 OpenAI / Anthropic 协议透传 endpoint，OpenClaw 把 baseUrl 改到 why01 即可，不需要它"原生支持"。

下一步

• 单一 IM 通道 / 不需要多通道 → 用 Claude Code / Codex / OpenCode 任一更轻
• 想横向比较 → CC-Switch
• OpenClaw 官方文档 → https://docs.openclaw.ai
• 仓库 → https://github.com/openclaw/openclaw