OpenClaw配置教程 - 阡陌数智API文档

一、基本介绍
OpenClaw 是一款开源的个人 AI 助理，支持本地或远程部署，适用于任何操作系统的 AI 智能体网关，支持 WhatsApp、Telegram、Discord、iMessage、飞书、QQ、钉钉等。
系统要求：Node 22+、macOS/Linux/Windows(WSL2)
二、安装
2.1 脚本安装（推荐）
curl -fsSL https://openclaw.ai/install.sh | bash
openclaw --version
OpenClaw 配置向导

首先，我们启动交互式配置向导：openclaw onboard

1.我们直接选择快速开始（QuickStart）:

2.
直接选择 “跳过”（Skip for now）

3.
选择 “All providers”

4.
选择 “Keep current”

5.
聊天工具也可以先选择 “跳过”（Skip for now）

6.
配置 Skills，也可以先选择 “跳过”（Skip for now），用空格键勾选，回车键确认

7.
推荐把以下三个选项都选上，如下：

三、配置第三方 API
安装后，在 OpenClaw 目录下会有 openclaw.json 文件：

open ~/.openclaw

打开 openclaw.json，配置第三方 API（OpenAI 兼容格式）：
{
  "gateway": { "mode": "local" },
  "agents": {
    "defaults": {
      "model": { "primary": "qmszai-api/claude-sonnet-4-5-20250929" },
      "models": { "n1n-api/claude-sonnet-4-5-20250929": {} }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "n1n-api": {
        "baseUrl": "https://qmszai.cn/v1",
        "apiKey": "sk-xxxxx",
        "api": "openai-completions",
        "models": [{
          "id": "claude-sonnet-4-5-20250929",
          "name": "claude-sonnet-4-5-20250929 (n1n-api)",
          "reasoning": false,
          "input": ["text"],
          "contextWindow": 128000,
          "maxTokens": 32000
        }]
      }
    }
  }
}

模型的名称需要与模型广场中的模型名称保持一致，可以直接复制过来。
四、启动网关
openclaw gateway

遇到网关问题：
执行下面整套操作

杀掉全部残留 node/openclaw 进程
cmd
taskkill /f /im node.exe 2>nul
taskkill /f /im openclaw.exe 2>nul

执行 doctor 诊断修复
cmd
openclaw doctor
如果输出有异常项，执行自动修复：
cmd
openclaw doctor --fix

强制重装 gateway 服务
cmd
openclaw gateway install --force
openclaw gateway restart
查询 gateway 运行状态
cmd
openclaw gateway status

前台启动 gateway，抓取真实崩溃堆栈（关键）
cmd
cd C:\Users\Administrator\.openclaw
node gateway/index.js
不要双击 cmd 脚本，直接用 node 执行 js，错误堆栈会直接打印在控制台，不会被重定向吞掉。
两种结果处理
情况 1：前台运行后，控制台不再退出，保持挂起，没有报错
代表 gateway 正常启动，监听 127.0.0.1:18789。
新开另一个 CMD 窗口运行：
cmd
openclaw run
就可以正常进入对话。
缺点：前台窗口不能关闭，一关 gateway 就停止。Windows 计划任务 scheduledtask 方式在当前环境存在 bug，后台驻留模式不可用。
Web 网页使用的妥协工作流（这个版本无解，只能这样用）
浏览器访问 http://127.0.0.1:18789；
执行 openclaw gateway auth-token --show，复制输出的令牌填入网页登录；
在聊天框发送提问；
页面转圈卡住、控制台打印code=1001 disconnected → 直接 F5 刷新浏览器页面，AI 回复立刻显示出来。
不要把浏览器标签页切后台休眠，会加重 websocket 断连频率。新建会话可以缓解部分异常。