OpenClaw 是一款开源 AI 个人助手，可部署在个人设备上，通过 Slack、Telegram、WhatsApp、Discord 等聊天应用或 Web 控制面板交互，能实现邮件处理、日历管理、代码编写、智能家居控制、网页数据抓取等功能，堪称 24 小时在线的私人 AI 打工人。

很多小伙伴好奇其实际使用效果，但在部署过程中，第三方中转接口接入与模型自定义配置常成为“卡脖子”难题。本文将从零开始，详细讲解 OpenClaw 的安装、基础配置、第三方中转接入及日常使用方法，帮你快速上手这款开源 AI 助手。

一、前期准备：明确环境与核心流程

1.1 核心流程梳理

整个部署配置过程分为 3 步，循序渐进、缺一不可：

1. 安装 OpenClaw 核心程序

2. 运行初始化向导（onboard），完成基础配置

3. 配置网关服务，接入第三方中转 API

1.2 环境要求

核心依赖：Node.js ≥ 22.12.0（需提前从 Node.js 官网 下载安装，对应自己的操作系统选择版本）。

二、从零安装：OpenClaw 基础部署

2.1 三种安装方式（按需选择）

推荐优先使用官方脚本安装，操作最简单；源码安装适合需要自定义修改程序的进阶用户。

2.2 安装验证

安装完成后，打开终端（Windows 打开 PowerShell），执行以下命令验证是否安装成功：

openclaw --version

若终端显示 OpenClaw 的版本号，即为安装成功；若提示“命令不存在”，需检查 Node.js 环境是否配置正确，或重新执行安装命令。

三、初始化配置：运行 Onboard 向导

安装成功后，通过初始化向导完成基础配置，向导会以交互式方式引导操作，无需手动修改复杂配置文件，新手友好。

3.1 启动向导

终端执行以下命令，启动 Onboard 初始化向导：

openclaw onboard

3.2 向导关键操作步骤（新手推荐）

1. 安全提示：阅读完安全说明后，输入Yes 继续。

2. Onboarding 模式：选择 QuickStart（快速启动，推荐新手），默认使用端口 18789，绑定本地地址 127.0.0.1。

3. 可选配置跳过：AI 模型、聊天渠道（Slack/Telegram 等）、API_KEY、Skills（技能）、Hooks（钩子），可全部暂时跳过，后续在“第三方中转接入”环节统一配置，避免重复操作。

3.3 保存关键信息（必做）

向导结束时，会显示 Control UI 相关信息，务必妥善保存，后续登录 Web 控制台、配置网关会用到：

• Web UI：http://127.0.0.1:18789/

• Web UI（带 token，推荐使用）：http://127.0.0.1:18789/#token=你的专属token

• Gateway WS：ws://127.0.0.1:18789

💡 重要提醒：后续务必使用“带 token 的 Web UI 链接”打开控制台，否则会出现“token_missing”（令牌缺失）或“too many failed authentication attempts”（认证失败次数过多）错误。若忘记链接，可执行 openclaw dashboard 自动打开带 token 的浏览器页面。

四、网关配置：必做步骤（解决启动失败问题）

网关服务是 OpenClaw 运行的核心，负责连接聊天渠道、接收处理消息，必须配置完成后才能正常使用。常见失败原因：未使用管理员权限执行命令。

4.1 两种网关启动方式（按需选择）

4.2 常见问题解决

若提示「Gateway service install failed」（网关服务安装失败）或「schtasks create failed」（计划任务创建失败），大概率是未使用管理员权限。解决方案：关闭当前终端，以管理员身份重新打开，再执行网关安装/启动命令。

五、核心操作：接入第三方中转 API（以 一步API 为例）

OpenClaw 需接入第三方中转 API（如 一步API：https://yibuapi.com） 才能调用 AI 模型，一步API 支持 OpenAI、Anthropic、Gemini 三种协议，其他中转平台操作类似，只需修改基础地址（baseUrl）和 API Key 即可。

5.1 找到配置文件

OpenClaw 的核心配置文件为 openclaw.json，不同系统路径不同：

• Windows 系统：C:\Users\你的用户名.openclaw\openclaw.json

• macOS / Linux 系统：~/.openclaw/openclaw.json

5.2 修改配置文件（关键步骤）

1. 用记事本（Windows）或 VS Code（全系统）打开 openclaw.json；

2. 将文件中全部内容，替换为下方的配置模板（重点修改 2 处：API Key 和 workspace 路径）；

3. 保存文件后，重启网关服务（关闭前台运行的网关窗口重新执行 openclaw gateway，或执行 openclaw gateway start）；

4. 用之前保存的“带 token 的 Web UI 链接”打开控制台，即可完成中转接入。

5.3 配置模板（直接复制使用）

⚠️ 注意事项：

• 将 YOUR_YIBU_API_KEY 替换为你自己的 一步API Key；

• workspace 路径：Windows 系统需写成双反斜杠（\），示例："C:\Users\你的用户名\.openclaw\workspace"；macOS/Linux 系统可写成 "/Users/你的用户名/.openclaw/workspace"；

• gateway.auth.token 需填写 Onboard 向导中获得的专属 token，切勿在公开平台粘贴真实 token，避免泄露。

{
  "version": "1.0.0",
  "workspace": "C:\\Users\\你的用户名\\.openclaw\\workspace", // 替换为自己的路径
  "gateway": {
    "host": "127.0.0.1",
    "port": 18789,
    "auth": {
      "token": "你的专属token" // 替换为Onboard向导获得的token
    },
    "cors": {
      "enabled": true,
      "origins": ["*"]
    }
  },
  "models": {
    "providers": [
      {
        "name": "yibuapi",
        "type": "openai", // 支持openai/anthropic/gemini，根据中转平台调整
        "config": {
          "baseUrl": "https://yibuapi.com/v1", //一步api默认基础地址，其他中转替换此处
          "apiKey": "YOUR_YIBU_API_KEY" // 替换为你的 一步API Key
        }
      }
    ],
    "defaults": {
      "completion": "gpt-4o-mini", // 默认模型，可按需调整
      "embedding": "text-embedding-3-small"
    }
  },
  "agents": {
    "defaults": {
      "model": "gpt-4o-mini",
      "provider": "yibuapi"
    }
  },
  "skills": {
    "enabled": true,
    "path": "${workspace}/skills"
  },
  "hooks": {
    "enabled": true,
    "path": "${workspace}/hooks"
  }
}

5.4 其他中转平台适配

若不使用 一步API ，只需修改配置模板中的 2 处：

1. baseUrl：替换为对应中转平台的 API 基础地址；

2. type：根据中转平台支持的协议，修改为 openai/anthropic/gemini 其中一种。

六、日常使用：启动与管理技巧

6.1 核心组件区别（避免误关服务）

OpenClaw 有两个核心组件，需明确其作用和运行要求，避免因关闭窗口导致服务中断。

6.2 开机后快速使用方法

• 若已安装守护进程（管理员权限操作）：开机后 Gateway 会自动启动，终端执行 openclaw status，显示「Gateway service: running」即为正常。

• 若未安装守护进程：每次使用前，打开终端执行 openclaw gateway，保持窗口不关闭，再打开 Web 控制台即可。

6.3 Gateway 服务手动管理命令

七、功能解锁：OpenClaw 能做什么？

配置好 API Key 与第三方中转后，OpenClaw 可作为全能私人助理，以下场景需在 Web 控制台或聊天渠道中，按需配置对应技能和权限。

更多详细用法，可参考 OpenClaw 官方文档与社区技能市场。

八、常用命令速查（收藏备用）

整理高频使用命令，无需记复杂路径，直接复制执行即可。

九、快速上手路线图（新手必看）

按以下步骤操作，10 分钟即可完成部署并使用 OpenClaw：

1. 安装 Node.js 22.12.0 及以上版本（官网下载）；

2. 终端执行 npm install -g openclaw（或使用官方脚本安装）；

3. 执行 openclaw onboard，选择 QuickStart 模式，跳过可选配置，保存 token 信息；

4. 找到 openclaw.json 配置文件，替换为本文提供的模板，修改 API Key 和 workspace 路径；

5. 启动网关（openclaw gateway 或 openclaw gateway start）；

6. 执行 openclaw dashboard，打开 Web 控制台，即可与 OpenClaw 交互使用。