OpenClaw

目前最火的开源个人 Agent（GitHub 上星标最多的软件项目之一）。它在你自己的电脑上跑一个 Gateway，把 微信之外的几乎所有聊天软件——Telegram、Discord、Slack、WhatsApp、iMessage 等——接到 AI 上，让它替你收发消息、整理收件箱、查行程、跑脚本。 原生支持 自定义 OpenAI 兼容端点，接入本站只要在向导里选一次 Custom Provider。

本页内容

• 它到底能干什么
• 第一步：安装
• 第二步：跑一次配置向导
• 第三步：把本站填进向导（关键）
• 第四步：启动网关、打开控制台
• 第五步：发第一条消息并确认走本站
• 进阶：直接改配置文件
• 常用命令
• 常见问题
• 安全与费用提醒

它到底能干什么

一句话：别人用手机给你发消息，你的 AI 在你自己电脑上干活。 它不是聊天窗口，而是一个常驻后台的「接线员」——把聊天软件、AI 模型、本机工具三头连起来。

关键词解释：Gateway（网关）＝常驻后台的那个程序，它是所有消息的入口；onboard（引导）＝第一次运行时的问答式配置向导。

第一步：安装

macOS / Linux / WSL2（最省事，会自动装 Node.js 和其它依赖）：

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

Windows（PowerShell）：

iwr -useb https://openclaw.ai/install.ps1 | iex

已经有 Node.js 的话，也可以直接用 npm 装：

npm install -g openclaw@latest

装完关掉终端重新开一个，确认能识别命令：

openclaw --version

官方还提供 macOS / Windows / Linux 的桌面应用（图形化安装，连 Gateway 一起装好），不习惯命令行的可以到官网 openclaw.ai 下载。本页以命令行方式讲解，桌面端配置模型的思路完全一样。

第二步：跑一次配置向导

安装脚本通常会自动进入向导；如果没有，手动跑一次：

openclaw onboard

向导开头会让你选 Quick start（快）或 Custom setup（完整）。两个都能配好本站，差异只是问得多不多。建议第一次用 Custom setup，看得更清楚。

OPENCLAW_LOCALE=zh-CN openclaw onboard

第三步：把本站填进向导（关键一步）

向导问「用哪个模型服务商」时，列表里都是 Anthropic、OpenAI、Google 这些官方选项—— 本站不在列表里，要选屏幕下方的「More…」子菜单，再选 Custom Provider （自定义服务商）。这一步很多人找不到，其实就藏在「更多」里。

选完 Custom Provider 后，按下面这张表照抄：

向导会当场拿你的配置真发一次请求来验证。看到通过（Inference ready / 验证成功）就说明接入没问题； 失败它会让你重试、换服务商或跳过，把错误信息照原样发给客服即可。

第四步：启动网关、打开控制台

把 Gateway 装成后台服务（开机自启，关掉终端也不停）：

openclaw gateway install

确认它在跑：

openclaw gateway status

打开浏览器控制台（聊天、改配置、看会话都在这个界面）：

openclaw dashboard

浏览器会打开 http://127.0.0.1:18789/——能看到界面就说明 Gateway 正常。

第五步：发第一条消息并确认走本站

1. 在刚打开的控制台里，输入框直接发一句「你好，请自我介绍一下」；
2. 能正常回复 = 全流程通了；
3. 确认流量真的经过本站：回控制台网站的「使用日志」，刷新后应该能看到刚才这笔调用（模型名、时间、消耗）。看不到就说明请求发去了别处，检查第三步的 base URL 与模型名。

想用手机聊：向导或 openclaw channels add 里加 Telegram 最快（只要一个 bot token）。接完之后记得在白名单里限制只有你能给它发消息。

进阶：直接改配置文件（等价方式）

所有配置都在一个文件里：~/.openclaw/openclaw.json （Windows 是 C:\Users\你的用户名\.openclaw\openclaw.json，用记事本打开即可）。 它用的是 JSON5 格式——允许写注释、允许键名不加双引号，比普通 JSON 好读。

要手动加本站，把内容改成这样：

{
  agents: {
    defaults: {
      model: { primary: "juheai/deepseek-v4-pro" },
    },
  },
  models: {
    mode: "merge",
    providers: {
      juheai: {
        baseUrl: "https://api.juheai.shop/v1",
        apiKey: "${JUHEAI_API_KEY}",
        api: "openai-completions",
        timeoutSeconds: 300,
        models: [
          {
            id: "deepseek-v4-pro",
            name: "DeepSeek V4 Pro",
            contextWindow: 128000,
            maxTokens: 8192,
          },
          {
            id: "deepseek-v4-flash",
            name: "DeepSeek V4 Flash",
            contextWindow: 128000,
            maxTokens: 8192,
          },
        ],
      },
    },
  },
}

如果用环境变量存密钥，先设一次（写进 ~/.zshrc 或 ~/.bashrc 可长期生效）：

export JUHEAI_API_KEY="sk-你的密钥"

Windows PowerShell 临时设置：$env:JUHEAI_API_KEY="sk-你的密钥"；永久设置用 setx JUHEAI_API_KEY "sk-你的密钥"（设完要重开终端）。

小知识：本站这类非官方端点，OpenClaw 会自动做兼容处理（关掉官方专有的请求字段、不发送 developer 角色、不加隐藏署名头、不压缩缓存提示）， 所以通常不需要你额外配什么。真遇到上游不认某个字段的报错，在模型里加兼容开关即可，见下方「常见问题」。

常用命令

常见问题

向导里根本找不到「自定义服务商」

它在服务商列表底部的 More…（更多）里，名字是 Custom Provider。列表太长容易漏看。也可以用经典向导：openclaw onboard --classic，在 Model/Auth 那一步就能直接选自定义类型（OpenAI 兼容 / Responses 兼容 / Anthropic 兼容）。

报 401 / 403 / 密钥无效

• 401：密钥填错或没生效 → 回本站「API 密钥」页确认，重新复制一次（注意别把前后空格带进去）。
• 403：密钥被停用或删除 → 在密钥列表里看状态。
• 用环境变量的话，确认设完变量后重开过终端，而且变量名和配置文件里 ${...} 写的完全一致。

报模型不存在 / 找不到模型

多半是模型名写错了。规则：agents.defaults.model.primary 里的 后半段必须和 models[].id 一字不差，而 models[].id 又必须是本站真实模型名（去「模型广场」查）。注意大小写和横线，不要把显示名当模型名。

报不支持 developer 角色 / 不认某个字段

• 本站这类非官方端点，OpenClaw 默认已自动关闭 supportsDeveloperRole，一般不会遇到；若仍报错，在对应模型里显式加：compat: { supportsDeveloperRole: false }。
• 若报 reasoning_effort 不被支持：给该模型加 compat: { supportsReasoningEffort: false }。
• 需要给上游塞厂商私有字段：用 params.extra_body（或 extraBody）。

上下文长度显示得特别小（比如只有几千）

说明没探测到模型的上下文窗口。在 models[].id 那一项里显式写明 contextWindow（例如 128000）和 maxTokens（例如 8192），保存后重启 Gateway。

响应慢、动不动超时

给这个服务商加一个更宽松的超时（单位秒）：

timeoutSeconds: 300

写在 providers.juheai 这一层。注意它管的是模型连接与流式读取；如果你另外调过全局或单次运行的超时上限，那个也要一起放宽。

装完提示 openclaw: command not found

安装成功了但当前终端还没加载新路径。关掉终端重新开一个；macOS / Linux 也可以执行 source ~/.zshrc（或 source ~/.bashrc）后重试。

npm 装的时候一直卡住 / 报网络错误

换成国内镜像再装（装完可以换回来）：

npm config set registry https://registry.npmmirror.com
npm install -g openclaw@latest

换回官方源：npm config set registry https://registry.npmjs.org

改了配置没变化

配置文件不会自动重载，执行 openclaw gateway restart 之后再试。

怎么换模型 / 加第二个模型

两种方式：命令行 openclaw models set juheai/模型名（需要该模型已在 models 列表里）；或直接在配置文件里给 models 数组多加一项，每项至少要有 id，改完重启 Gateway。

安全与费用提醒

费用方面：这类自主 Agent 会长时间运行、反复调用模型，很容易在你不注意时烧掉不少额度。建议在控制台给 专门建一把密钥并单独设置额度上限，模型单价见 模型广场。

OpenClaw 由 Peter Steinberger 发起，现由 OpenClaw Foundation（独立 501(c)(3) 组织）维护，MIT 许可。 官网：openclaw.ai， 文档：docs.openclaw.ai， 源码：github.com/openclaw/openclaw。 本站不代为分发安装包，也不隶属于该项目。