OpenClaw 接入 ClaudeAPI.com 完整教程：5分钟搭建你的个人 AI 助手
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。
第 2 步：输入 API Key
Enter your API key:
> （粘贴你的 ClaudeAPI.com API Key，回车确认）
Enter your API key:
> （粘贴你的 ClaudeAPI.com API Key，回车确认）
第 3 步：选择默认模型
Select your default model:
> claude-sonnet-4-6 ← 推荐，均衡性价比
claude-opus-4-7 ← 最强，复杂任务用
claude-haiku-4-5 ← 最快，简单问答用
Select your default model:
> claude-sonnet-4-6 ← 推荐，均衡性价比
claude-opus-4-7 ← 最强，复杂任务用
claude-haiku-4-5 ← 最快，简单问答用
新手建议选 claude-sonnet-4-6。
第 4 步：配置 ClaudeAPI.com 自定义 baseUrl（关键步骤）
向导默认会把请求发到 Anthropic 官方服务器。要使用 ClaudeAPI.com 转发，必须手动配置 baseUrl。
重要：
baseUrl必须填写https://gw.claudeapi.com，这是 ClaudeAPI.com 的正确网关地址。
第 5 步：安装守护进程
向导会自动安装后台服务，直接确认即可。
重启网关使配置生效
# 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（注意不是 api.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 查看更多教程或联系客服支持。
