OpenClaw 接入指南

适用角色：开发者、部署管理员 更新日期：2026-08-06

OpenClaw 同时管理模型 Provider、Agent 和消息渠道。排查时把这三层分开：先确认模型能在本机对话，再开启网关，最后逐个增加消息渠道。

安装和初始化

OpenClaw 当前版本要求 Node.js 22 或更高版本。可以使用安装脚本：

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

也可以通过 npm 安装：

npm install -g openclaw@latest

PowerShell：

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

安装后运行：

openclaw --version
openclaw onboard

初始化阶段可以暂不配置消息渠道。先完成模型 Provider，后续问题会更容易定位。

注册 Provider

编辑 ~/.openclaw/openclaw.json，把下面字段合并到现有配置。不要覆盖文件中的其他 Agent 或渠道设置。

{
  "models": {
    "mode": "merge",
    "providers": {
      "myplatform": {
        "baseUrl": "https://<接口地址>",
        "apiKey": "${CUSTOM_API_KEY}",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "deepseek-v4-flash",
            "name": "DeepSeek V4 Flash"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "myplatform/deepseek-v4-flash"
      }
    }
  }
}

启动前设置环境变量：

export CUSTOM_API_KEY="YOUR_API_KEY"

这里使用 Messages Compatible，所以 Base URL 不带 /v1。Messages 协议（/v1/messages）是否可用，取决于该 Key 绑定分组的平台以及该分组是否允许 Messages 调度；不可用时会返回 403，改走 OpenAI Compatible 即可。OpenClaw 自定义模型中的 reasoning、input、contextWindow 和 maxTokens 都是可选能力声明。只有从控制台当前模型信息确认后才填写，不要从其他模型配置复制。

以控制台「API Key」页展示的接口地址为准。

重启并查看状态：

openclaw gateway restart
openclaw models list
openclaw status

模型列表中应出现 myplatform/deepseek-v4-flash。随后进行一次本地文本问答，并在控制台使用记录中核对请求。

网关安全

保持 OpenClaw 初始化生成的网关鉴权设置。需要从其他设备访问时，应按照当前版本的安全向导配置 Token，不要为了省事把远程网关设为无鉴权。

执行以下命令可以检查并修复常见安全配置：

openclaw doctor --fix

网关只在本机使用也应限制监听地址，避免意外暴露到局域网或公网。

接入飞书

当前 OpenClaw 提供飞书渠道登录向导。先在飞书开放平台创建企业自建应用，准备 App ID 和 App Secret，然后运行：

openclaw channels login --channel feishu

向导会在缺少时安装飞书插件，并引导填写凭据。应用侧需要启用机器人、配置消息相关权限，并订阅 im.message.receive_v1。完成配置后：

openclaw gateway restart
openclaw channels status --probe

首次私聊如果出现配对码，可由管理员审核：

openclaw pairing list feishu
openclaw pairing approve feishu PAIRING_CODE

权限范围应按实际使用场景开通，不需要的文档、云盘或通讯录权限不要一并授予。

接入微信

微信渠道由腾讯发布的外部插件提供。快速安装：

npx -y @tencent-weixin/openclaw-weixin-cli install

也可以手工安装并启用：

openclaw plugins install "@tencent-weixin/openclaw-weixin"
openclaw config set plugins.entries.openclaw-weixin.enabled true
openclaw gateway restart

发起二维码登录：

openclaw channels login --channel openclaw-weixin

登录后检查：

openclaw plugins list
openclaw channels status --probe

插件包和 OpenClaw 版本需要相互兼容。安装成功但渠道无法启动时，先检查两者版本，不要修改已经验证通过的 Provider。

接入钉钉或 QQ

钉钉和 QQ 通常通过外部渠道插件接入，包名、字段和维护状态可能变化。建议按以下流程操作：

1. 在 OpenClaw 当前版本的渠道目录或目标插件说明中确认包名和最低版本；
2. 查看插件发布方和最近更新时间；
3. 在对应开放平台创建应用或机器人，并只开通所需权限；
4. 使用 openclaw plugins install <插件包> 安装；
5. 优先运行 openclaw channels add 或插件提供的登录向导；
6. 重启后用 openclaw channels status --probe 检查。

不要直接复制其他版本的渠道 JSON。外部插件要求保存 App Secret 时，应使用 OpenClaw 当前支持的 Secret 或环境变量机制。

分层排查

每增加一个渠道都先做单独测试。多个渠道一起修改后再排查，很难判断问题来自模型、网关还是插件。