OpenClaw

OpenClaw 是一个开源、自托管的个人 AI 助手平台，把消息应用连接到运行在你自己硬件上的 AI 代理，无需交出数据控制权。

官方主页：https://openclaw.ai
项目文档：https://docs.openclaw.ai
GitHub：https://github.com/openclaw/openclaw

核心特性

多渠道集成：支持 Telegram、Discord、WhatsApp、iMessage 等消息渠道，也可以通过插件扩展；一个 Gateway 进程统一管理所有渠道。
语音与 Canvas：支持 macOS/iOS/Android 语音交互，可渲染交互式 Canvas 界面。
完全自托管：运行在你自己的机器或服务器上，MIT 开源，上下文和技能存储在本地。
智能代理能力：后台常驻、持久记忆、cron 定时任务、会话隔离、多代理路由，原生支持工具调用和代码执行。

接入前准备

Node.js 22 或更高版本
ZeroCat 的 API 地址：https://zero.cat/v1
一个 ZeroCat API 密钥

建议先按 OpenClaw 官方流程把 Gateway 和 Control UI 跑起来，再配置 ZeroCat。这样出问题时，更容易区分是 OpenClaw 本身没启动，还是模型配置有误。

1. 安装 OpenClaw（macOS / Linux）

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

其他安装方式见官方文档：Getting Started。

2. 运行引导向导

openclaw onboard --install-daemon

向导会完成基础认证、Gateway 设置和可选的渠道初始化。

3. 检查 Gateway 与 Control UI

openclaw gateway status
openclaw dashboard

浏览器能打开 Control UI，说明 OpenClaw 已正常运行。这一步不需要先配置消息渠道。

4. 找到配置文件

OpenClaw 的配置文件通常位于 ~/.openclaw/openclaw.json，在向导生成的基础上修改即可。

如果 OpenClaw 运行在专用服务账号下，或者想自定义配置和状态目录，可以使用环境变量 OPENCLAW_HOME、OPENCLAW_STATE_DIR、OPENCLAW_CONFIG_PATH，详见 Environment Variables。

配置 ZeroCat

OpenClaw 通过 models.providers 接入 OpenAI 兼容的模型服务。做法是把 ZeroCat 声明为一个自定义 provider，再把默认模型指向 zerocat/模型ID。先在 shell、服务环境或 OpenClaw 可读取的 .env 中设置密钥：

export ZEROCAT_API_KEY="sk-你的API密钥"

然后在 openclaw.json 中加入以下片段（模型 ID 是示例，请换成模型广场中你的分组可用的模型）：

{
  models: {
    mode: "merge",
    providers: {
      zerocat: {
        baseUrl: "https://zero.cat/v1",
        apiKey: "${ZEROCAT_API_KEY}",
        api: "openai-completions",
        models: [
          { id: "gpt-6.1-sol", name: "GPT-6.1 Sol" },
          { id: "deepseek-v4-pro", name: "DeepSeek V4 Pro" },
        ],
      },
    },
  },

  agents: {
    defaults: {
      model: {
        primary: "zerocat/gpt-6.1-sol",
        fallbacks: ["zerocat/deepseek-v4-pro"],
      },
      models: {
        "zerocat/gpt-6.1-sol": { alias: "gpt" },
        "zerocat/deepseek-v4-pro": { alias: "deepseek" },
      },
    },
  },
}

这不是完整配置，只是接入 ZeroCat 的关键部分。

配置项	说明
`models.mode`	建议设为 `merge`，保留 OpenClaw 内置 provider 的同时追加 ZeroCat
`models.providers.zerocat.baseUrl`	`https://zero.cat/v1`，必须带 `/v1`
`models.providers.zerocat.apiKey`	ZeroCat API 密钥，推荐通过 `${ZEROCAT_API_KEY}` 注入
`models.providers.zerocat.api`	使用 `openai-completions`
`models.providers.zerocat.models`	模型 ID 必须与 ZeroCat 中的模型 ID 完全一致
`agents.defaults.model.primary`	默认主模型，格式为 `provider/model-id`
`agents.defaults.model.fallbacks`	备选模型，主模型失败时自动切换
`agents.defaults.models`	可选，给模型起别名

验证

openclaw dashboard
openclaw models list

能在 OpenClaw 中正常对话，并且 zerocat/ 开头的模型出现在列表中，说明接入成功。

常见问题

baseUrl 没带 /v1：这是最常见的错误。
模型 ID 填错：primary 和 fallbacks 必须与 models 里的 id 对应。
密钥只在当前终端生效：Gateway 以后台服务运行时，要确保服务进程也能读取到 ZEROCAT_API_KEY。
想看实时日志：用 openclaw gateway --port 18789 前台运行，观察日志和报错。

AI 编程工具

AI 客户端

机器人与智能体

翻译工具

核心特性

接入前准备

1. 安装 OpenClaw（macOS / Linux）

2. 运行引导向导

3. 检查 Gateway 与 Control UI

4. 找到配置文件

配置 ZeroCat

验证

常见问题

​核心特性

​接入前准备

​1. 安装 OpenClaw（macOS / Linux）

​2. 运行引导向导

​3. 检查 Gateway 与 Control UI

​4. 找到配置文件

​配置 ZeroCat

​验证

​常见问题

核心特性

接入前准备

1. 安装 OpenClaw（macOS / Linux）

2. 运行引导向导

3. 检查 Gateway 与 Control UI

4. 找到配置文件

配置 ZeroCat

验证

常见问题