OpenClaw

把 OpenClaw 自主式 agent 框架接入 OPL 数据空间。

OpenClaw 是一个开源、自托管的自主式 AI agent 框架。它让 AI 获得“动手能力”，可以执行 shell 命令、读写文件、浏览网页，并接入 Telegram、Slack、WhatsApp 等消息平台。

OpenClaw 提供 OpenAI 兼容 API 端点，因此非常适合作为 OPL 数据空间 的后端。常见集成方式有两种：

方式	适用场景
API 连接	把 OPL 数据空间 作为 OpenClaw agent 的主聊天前端
频道插件	让 OpenClaw bot 和人类一起参与 OPL 数据空间 频道

你需要准备

• 已安装 OpenClaw
• Node.js 22+，推荐 24
• 至少一个可用的 LLM provider API Key
• 正在运行的 OPL 数据空间
• 大约 15 分钟

---

Method 1: API Connection

把 OPL 数据空间 作为 OpenClaw agent 的主聊天界面。这是最简单、最常见的方式。

第 1 步：安装 OpenClaw

如果尚未安装：

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

# Windows (PowerShell)
iwr -useb https://openclaw.ai/install.ps1 | iex

或者：

npm install -g openclaw@latest

安装后执行初始化：

openclaw onboard

第 2 步：启用 OpenAI 兼容 API

默认出于安全原因，这个端点是关闭的。请在配置文件中开启：

{
  "gateway": {
    "http": {
      "endpoints": {
        "chatCompletions": {
          "enabled": true
        }
      }
    }
  }
}

如果 gateway 已经在运行，需要重启它。

第 3 步：启动 Gateway

openclaw gateway

默认监听端口是 18789。你可以用下面的命令检查状态：

openclaw gateway status

第 4 步：在 OPL 数据空间 中添加连接

1. 打开 OPL 数据空间。
2. 前往 ⚙️ 管理设置 → 连接 → OpenAI。
3. 点击 ➕ 添加连接。
4. 填入：

设置项	值
URL	http://localhost:18789/v1
API Key	你的 OpenClaw Gateway bearer token

5. 点击 ✅ 验证，然后 保存。

OPL 数据空间 在 Docker 中运行？

把 localhost 换成：

http://host.docker.internal:18789/v1

第 5 步：开始聊天

现在 OpenClaw agent 应该会出现在模型下拉列表里。选中后即可开始聊天，agent 会通过 OpenClaw 自己配置好的工具系统执行任务。

指定特定 agent

OpenClaw 会通过模型名路由到不同 agent：

Model ID	路由目标
openclaw/default	默认 agent
openclaw/<agentId>	指定命名 agent

如果你配置了多个 agent，它们会作为不同“模型”出现在下拉中。

---

方法二：频道插件

社区插件

频道插件是 社区贡献的集成，不是 OPL 数据空间 或 OpenClaw 官方维护。使用时请自行评估风险，并以其 插件仓库 为准。

如果你希望 OpenClaw 以 bot 用户身份参与 OPL 数据空间 频道，可以使用这个社区插件。

第 1 步：在 OPL 数据空间 中创建机器人账号

1. 以管理员身份登录 OPL 数据空间。
2. 前往 管理面板 → 用户。
3. 创建一个专门给 bot 使用的账号，例如 openclaw-bot@yourdomain.com。
4. 把它加入你希望监听的频道。

备注

请确保实例已启用 Channels，位置在 管理设置 → 通用。

第 2 步：安装插件

在 OpenClaw 的私密聊天环境中，告诉 agent：

I want to use the OPL 数据空间 Channels plugin: https://github.com/skyzi000/openclaw-open-webui-channels

OpenClaw 会自动下载并安装该插件。

第 3 步：配置连接

再告诉 OpenClaw：

I want to connect到OPL 数据空间 Channels.

它会提示你填写：

设置项	填写内容
Base URL	OPL 数据空间 地址，例如 http://localhost:3000
Email	机器人账号邮箱
Password	机器人账号密码
Channel IDs	可选，指定频道 ID；留空则监听所有

安全提示

请只在私密聊天中配置凭据。插件会把这些信息写入 ~/.openclaw/openclaw.json 的 channels.open-webui 配置段。

第 4 步：验证

在 OPL 数据空间 中打开一个已连接的频道，并 @ 这个 bot 用户。如果它能回应，说明集成成功。

---

OpenClaw 自带仪表盘

OpenClaw 还内置了一个无需额外安装的 Web 仪表盘，可用于管理 agent、查看日志与监控资源：

openclaw dashboard

默认地址是 http://localhost:18789。通常可以把它和 OPL 数据空间 搭配使用：用 dashboard 管理 agent，用 OPL 数据空间 进行对话。

---

故障排查

Connection refused

• 确认 gateway 正在运行：openclaw gateway status
• 确认端口是 18789
• 确认 URL 结尾包含 /v1

验证通过但模型不显示

URL 必须是 http://localhost:18789/v1，/v1 用于模型发现。

Docker 网络问题

如果 OPL 数据空间 在 Docker 中运行，localhost 指向的是容器本身，需要改用 host.docker.internal。Linux 无 Docker Desktop 时可以：

docker run --add-host=host.docker.internal:host-gateway ...

频道 bot 没响应

• 确认 bot 用户已加入目标频道
• 确认实例已启用 Channels
• 检查 ~/.openclaw/openclaw.json 中保存的插件凭据是否正确