OpenClaw 配置
OpenClaw 是面向 AI 编程与命令行工作流 的工具，适合在本地环境中进行模型调用和交互。
如果你已经熟悉 Codex、Claude Code 或 OpenCode 的配置流程，OpenClaw 也可以按类似方式接入。
安装前说明
| 要求 | 说明 |
|---|---|
| Node.js | 22+（安装脚本会自动检测） |
| 系统 | macOS / Linux / Windows |
第一步：安装 OpenClaw
官方推荐优先使用安装脚本。
Windows（PowerShell）
iwr -useb https://openclaw.ai/install.ps1 | iex
macOS / Linux
curl -fsSL https://openclaw.ai/install.sh | bash
WSL2 用户也使用上面这一条。
安装脚本会自动处理 Node 检测、安装和初始引导流程。
已有 Node 22+ 时用 npm
npm install -g openclaw@latest
openclaw onboard --install-daemon
权限不足时：
sudo npm install -g openclaw@latest
openclaw onboard --install-daemon
第二步：验证安装
第一次运行时先执行：
openclaw setup
完成初始化后，打开两个终端窗口：
| 窗口 | 命令 | 作用 |
|---|---|---|
| 第一个 | openclaw gateway | 启动网关服务 |
| 第二个 | openclaw tui | 打开终端交互界面 |
如果 TUI 能正常出现界面或交互提示，说明安装成功。
第三步：配置接入
OpenClaw 支持通过 CC-Switch 添加供应商。CC-Switch 下载：https://github.com/farion1231/cc-switch/releases
- 打开 CC-Switch，在上方切换到 OpenClaw
- 点 添加供应商
- 在「预设供应商」中选择 187API，或手动填写：
| 配置项 | 值 |
|---|---|
| API 协议 | OpenAI Completions |
| API 端点 | https://187api.com/v1 |
| API Key | 你的 sk-... 令牌 |
| 发送 User-Agent | 保持开启 |
| 模型 ID | 当前分组下可用的模型名 |
信息
模型名称请到 模型广场 查看实际可用模型后再填写。
配置要点
这五项是最容易填错的：
| 项 | 正确值 |
|---|---|
| API 协议 | OpenAI Completions |
| API 端点 | https://187api.com/v1（带 /v1） |
| API Key | 对应分组的令牌 |
| 发送 User-Agent | 开启 |
| 模型名称 | 以模型广场当前可用列表为准 |
第四步：验证
重新打开终端，再开两个窗口：
# 窗口 1
openclaw gateway
# 窗口 2
openclaw tui
在 TUI 中输入 你好，能正常返回内容即接入成功。
排错
| 现象 | 优先检查 |
|---|---|
openclaw 命令找不到 | PATH 没刷新，关掉终端重开；或重新执行安装脚本 |
| TUI 起不来 | 先确认 openclaw gateway 窗口正常运行 |
| 404 | API 端点少了 /v1 |
| 401 | API Key 不完整，或填成了带 Bearer 前缀的内容 |
| 模型不支持 | 模型名与模型广场不一致 |
相关：客户端接入总览 · Agent 客户端配置大全 · CC-Switch 配置 · [常见问题]../reference/faq/overview