OpenClaw 安装配置教程

一、方案简介

OpenClaw 是一个开源个人 AI 助手平台，支持自动化任务和本地化操作。它适合需要一个全天候运行、能处理定时任务和多渠道消息转发的开发者。

通过修改 API 地址指向 APIBox，我们可以在国内无缝使用 OpenClaw 平台，调用 GPT-5、Claude 和各大国产模型。

二、安装环境要求

• macOS：10.15+
• Linux：主流发行版（Ubuntu 18.04+、Debian 10+、CentOS 7+ 等）

三、安装步骤

1. 安装 OpenClaw

打开终端，运行以下一键安装命令：

curl -fsSL https://openclaw.ai/install.sh | bash

如果提示权限不足，可在命令前加 sudo：

sudo curl -fsSL https://openclaw.ai/install.sh | bash

安装完成后，终端会显示 OpenClaw 的版本号，说明基础安装成功。

2. 获取 API 密钥

前往 APIBox 控制台 获取你的 API Key。

提示：APIBox 价格约为官方 1/7，支持 GPT-5、Claude 4.6 系列以及 DeepSeek 等国产模型，人民币充值。

3. 配置 OpenClaw 使用 APIBox

运行以下命令初始化或编辑 OpenClaw 的配置（如果是首次安装，运行 openclaw onboard 会有交互式向导，你可以跳过向导直接修改配置文件）。

假设你使用 CLI，执行以下命令设置默认模型供应商和 API Key：

openclaw config set defaults.model "apibox/claude-sonnet-4-6"
openclaw config set providers.apibox.baseUrl "https://api.apibox.cc/v1"
openclaw config set providers.apibox.apiKey "你的_APIBox_Key"

如果你希望编辑 JSON 配置文件，打开 ~/.openclaw/openclaw.json，在 providers 节点中添加：

"providers": {
  "apibox": {
    "baseUrl": "https://api.apibox.cc/v1",
    "apiKey": "你的_APIBox_Key"
  }
}

4. 启动 OpenClaw

配置完成后，启动网关服务：

openclaw gateway start

你可以通过 openclaw gateway status 检查运行状态，或通过 openclaw logs --follow 查看实时日志。

四、常见问题排查

❌ 终端提示 command not found

原因： OpenClaw 的可执行文件没有被加入环境变量。 解决： 一般安装脚本会自动处理，如果失败，请手动将安装目录加入环境变量：

export PATH="$HOME/.openclaw/bin:$PATH"
source ~/.bashrc # 或 ~/.zshrc

❌ 无法连接到 APIBox

原因： baseUrl 缺少 /v1 尾缀，或者配置项写错了层级。 解决： 使用 openclaw config get providers.apibox 检查你的配置，确保 URL 完整：https://api.apibox.cc/v1。

❌ macOS 权限弹窗报错

原因： macOS 拦截了未签名程序的运行，或终端没有完全磁盘访问权限。 解决： 进入「系统设置 > 隐私与安全性 > 完全磁盘访问权限」，把你的终端应用打勾。如果是拦截程序，在「安全性」中点击「仍然允许」。