OpenClaw 是目前最热门的开源个人 AI 助手框架（GitHub 已超 60,000 星），它可以把 Claude 接入你的 Telegram、WhatsApp、Discord、Slack 等常用聊天平台，让 AI 随叫随到。
本文手把手带你用 ClaudeAPI.com 的 API Key 完成 OpenClaw 的全套配置。
一、OpenClaw 是什么？
OpenClaw 运行在你自己的电脑或服务器上，充当一个 本地 AI 网关（Gateway）：
- 接收来自 Telegram / WhatsApp / Discord 等平台的消息
- 转发给 Claude（通过你的 API Key）
- 把回复发回给你
好处显而易见：隐私可控、可扩展技能、多平台统一入口，而且你用的是自己的 API Key，完全按量付费，账号安全可靠。
二、前置条件
| 条件 | 说明 |
|---|---|
| 操作系统 | macOS / Linux / Windows（推荐 WSL2） |
| Node.js | 22 或更高版本（必须） |
| ClaudeAPI.com API Key | 登录 claudeapi.com 后台获取 |
| 聊天平台 Bot Token | Telegram BotFather / Discord 开发者后台等（至少配置一个） |
检查 Node.js 版本
node --version
# 输出应为 v22.x.x 或 v24.x.x
node --version
# 输出应为 v22.x.x 或 v24.x.x
如果版本低于 22，用以下命令升级：
# 使用 nvm（推荐）
nvm install --lts && nvm use --lts
# 使用 nvm（推荐）
nvm install --lts && nvm use --lts
获取 ClaudeAPI.com API Key
- 访问 claudeapi.com 注册/登录
- 进入后台 → API Keys → 创建新 Key
- 复制保存（以
sk-ant-开头）
三、安装 OpenClaw
macOS / Linux（推荐一键安装）
curl -fsSL https://openclaw.ai/install.sh | bash
curl -fsSL https://openclaw.ai/install.sh | bash
Windows（PowerShell 管理员模式）
iwr -useb https://openclaw.ai/install.ps1 | iex
iwr -useb https://openclaw.ai/install.ps1 | iex
备选：npm 全局安装
npm install -g openclaw@latest
npm install -g openclaw@latest
验证安装
openclaw --version
openclaw --version
看到版本号输出即表示安装成功。
四、运行配置向导
openclaw onboard --install-daemon
openclaw onboard --install-daemon
--install-daemon 会把 OpenClaw 网关注册为系统后台服务，电脑重启后自动运行，强烈推荐。
向导关键步骤
第 1 步：选择 AI 提供商
Which AI provider do you want to use?
Anthropic (Claude) — recommended
OpenAI (ChatGPT)
> Custom provider
Which AI provider do you want to use?
Anthropic (Claude) — recommended
OpenAI (ChatGPT)
> Custom provider
选择 Custom。ClaudeAPI.com 走的是自定义中转地址，所以不要选 Anthropic 官方项。
第 2 步：填写 API Base URL
这里填写 ClaudeAPI.com 的 OpenAI 兼容网关地址：
https://gw.claudeapi.com/v1
https://gw.claudeapi.com/v1
注意必须带 /v1。如果只填 https://gw.claudeapi.com，验证时可能出现 Verification failed: status 404。
第 3 步：提供 API Key
可以选择两种方式：
方式一：使用环境变量，推荐长期使用。
Use external secret provider
Environment variable
OPENAI_API_KEY
Use external secret provider
Environment variable
OPENAI_API_KEY
然后在系统环境变量中保存你的 ClaudeAPI.com API Key。
方式二：直接粘贴 API Key，适合新手快速测试。
Paste API key now
Paste API key now
然后粘贴 ClaudeAPI.com 后台生成的 API Key。
第 4 步：选择接口兼容类型
选择：
OpenAI-compatible (Uses /chat/completions)
OpenAI-compatible (Uses /chat/completions)
ClaudeAPI.com 的网关按 OpenAI 兼容接口调用，所以这里不要选 Anthropic-compatible。
第 5 步：填写 Model ID
填写 ClaudeAPI.com 后台真实支持的模型名，例如：
claude-sonnet-5
claude-sonnet-5
如果验证失败，不要随便改成不存在的模型名，应该去 ClaudeAPI.com 后台模型列表确认可用模型名称。
第 6 步：Model alias，可选
出现：
Model alias (optional)
Model alias (optional)
这里可以直接留空回车。
如果想设置短别名，也可以填：
sonnet
sonnet
新手建议留空，减少后续混淆。
第 7 步：验证成功
此处可以选择想要配置的
重启网关使配置生效
# macOS（launchd）
launchctl stop ai.openclaw.gateway
launchctl start ai.openclaw.gateway
# Linux（systemd）
systemctl --user restart openclaw-gateway
# 或直接手动重启
openclaw gateway restart
# macOS（launchd）
launchctl stop ai.openclaw.gateway
launchctl start ai.openclaw.gateway
# Linux（systemd）
systemctl --user restart openclaw-gateway
# 或直接手动重启
openclaw gateway restart
五、验证配置是否正常
方法一：命令行测试
openclaw chat "你好，请介绍一下你自己"
openclaw chat "你好，请介绍一下你自己"
看到 Claude 的回复说明配置成功。
方法二：查看 Dashboard
openclaw dashboard
openclaw dashboard
浏览器会打开本地控制面板 http://127.0.0.1:18789，在聊天框发送消息，收到回复即正常。
方法三：检查模型状态
openclaw models status
openclaw models status
应看到 Anthropic provider 状态为 active。
六、ClaudeAPI.com 可用模型
在配置文件中，agents.defaults.model.primary 可选以下模型（需加 anthropic/ 前缀）：
| 模型 ID | 建议用途 | 输入价格 | 输出价格 |
|---|---|---|---|
anthropic/claude-opus-4-7 |
复杂推理、长文档 | $4.000/1M | $20.000/1M |
anthropic/claude-sonnet-4-6 |
通用开发（推荐） | $2.400/1M | $12.000/1M |
anthropic/claude-haiku-4-5-20251001 |
快速问答 | $0.800/1M | $4.000/1M |
七、常见问题
Q: ANTHROPIC_API_KEY not set 错误
API Key 没有正确写入。执行以下命令确认：
# 方式一：环境变量
export ANTHROPIC_API_KEY="sk-ant-..."
# 方式二：写入配置文件
# 编辑 ~/.openclaw/agents/main/agent/auth-profiles.json
# 方式一：环境变量
export ANTHROPIC_API_KEY="sk-ant-..."
# 方式二：写入配置文件
# 编辑 ~/.openclaw/agents/main/agent/auth-profiles.json
{
"version": 1,
"profiles": {
"anthropic:default": {
"type": "api_key",
"provider": "anthropic",
"key": "sk-ant-你的ClaudeAPI-Key"
}
}
}
{
"version": 1,
"profiles": {
"anthropic:default": {
"type": "api_key",
"provider": "anthropic",
"key": "sk-ant-你的ClaudeAPI-Key"
}
}
}
Q: 请求报 401 / Invalid API key
检查 baseUrl 是否正确填写为 https://gw.claudeapi.com（注意不是 gw.claudeapi.com）。
Q: Windows 安装失败
强烈建议使用 WSL2 运行 OpenClaw，在 PowerShell 执行 wsl --install 安装后，在 WSL 环境中按 Linux 步骤操作。
Q: 网关启动后立刻停止
执行 openclaw doctor --fix 自动修复配置问题，或检查端口 18789 是否被占用。
八、进阶：安装技能（Skills）
OpenClaw 支持安装扩展技能，比如网页搜索、邮件处理、日历管理等：
# 查看可用技能
openclaw skills list
# 安装网页搜索技能
openclaw skills install web-search
# 查看可用技能
openclaw skills list
# 安装网页搜索技能
openclaw skills install web-search
总结
| 步骤 | 命令/操作 |
|---|---|
| 安装 OpenClaw | curl -fsSL https://openclaw.ai/install.sh | bash |
| 运行向导 | openclaw onboard --install-daemon |
| 配置 ClaudeAPI baseUrl | 编辑 ~/.openclaw/openclaw.json |
| 重启网关 | openclaw gateway restart |
| 验证 | openclaw chat "你好" |
完成以上步骤，你就拥有了一个运行在本地、通过 ClaudeAPI.com 访问 Claude 的个人 AI 助手，可以在 Telegram、Discord 等平台随时与它对话。
如有问题，欢迎访问 claudeapi.com 查看更多教程或联系客服支持。
