部署 OpenClaw 插件

本指南将引导你在飞函工作台中将 OpenClaw 插件部署为机器人。完成后,团队成员即可在飞函客户端中直接与 OpenClaw 机器人对话。

前提条件

如果你尚未安装飞函服务端,请先按照快速安装指南搭建服务端环境。

第 1 步 — 创建新应用

  1. 登录飞函管控台,导航至工作台 > 应用管理
  2. 点击右上角的新增应用按钮。

点击新建应用以创建应用

第 2 步 — 填写应用信息

创建企业应用对话框中,填写以下字段:

字段
应用名称例如:飞函龙虾
应用描述简要描述机器人的用途
应用图标上传一个便于识别的图标
应用分组从下拉菜单中选择已有分组,或根据需要新建一个

点击确定完成应用创建。

填写应用信息并点击确定

第 3 步 — 打开应用详情

应用创建完成后,你将在应用列表中看到 OpenClaw。点击详情进入应用配置页面。

点击详情以配置应用

第 4 步 — 启用机器人能力

  1. 应用详情页面中,向下滚动到应用能力区域。你会看到一个默认关闭的机器人开关。
  2. 点击页面底部的编辑按钮。

点击编辑以修改应用设置

  1. 打开机器人开关以启用该应用的机器人能力,然后点击保存

启用机器人开关并点击保存

第 5 步 — 复制应用凭证

保存后,从页面顶部的应用凭证区域复制 App IDApp Secret。配置 OpenClaw 插件时需要用到这些凭证。

Warning

请妥善保管 App Secret,不要公开分享或提交到版本控制系统中。

复制 App ID 和 App Secret

第 6 步 — 安装并配置 OpenClaw 插件

前提条件

请确保在继续之前已在你的机器上安装了 OpenClaw

安装插件

在运行 OpenClaw 的机器上打开终端,执行以下命令:

openclaw plugins install @feihan-im/openclaw-plugin

配置频道

运行以下命令,将三个占位符替换为你在第 5 步中复制的值:

openclaw channels add --channel feihan \
  --app-token <APP_ID> \
  --token <APP_SECRET> \
  --url <BACKEND_URL>
参数填写内容获取位置
--app-tokenApp ID飞函管控台 → 工作台 → 应用管理 → 应用详情
--tokenApp Secret与 App ID 同一页面(请视为密码,切勿分享)
--url你的飞函服务端地址例如 http://192.168.10.10:21000

管理多个账号(可选)

添加账号

如果需要接入多个飞函机器人,可以使用 --account 参数为新账号指定名称:

openclaw channels add --channel feihan \
  --account bot2 \
  --app-token <APP_ID> \
  --token <APP_SECRET> \
  --url <BACKEND_URL>

--account 的值是你自定义的名称(例如 bot2sales-bot),用于标识该账号。第 6 步中配置的第一个账号会自动命名为 default。所有账号在网关启动时独立运行。

停用账号

如需临时停止某个机器人账号而不删除其配置:

openclaw channels remove --channel feihan --account <ACCOUNT_ID>

如需重新启用,编辑 ~/.openclaw/openclaw.json,将该账号条目的 "enabled" 设为 true(或直接删除 "enabled" 字段——账号默认为启用状态)。

删除账号

如需永久移除某个机器人账号并删除其配置:

openclaw channels remove --channel feihan --account <ACCOUNT_ID> --delete
Tip

每次账号变更(添加、停用、启用或删除)后,请运行 openclaw gateway restart 重启网关以使更改生效。

重启网关

配置完成后,重启网关以应用更改:

openclaw gateway restart

高级配置

如需修改其他设置(例如加密或请求超时),编辑 ~/.openclaw/openclaw.json

{
  "channels": {
    "feihan": {
      "accounts": {
        "default": {
          "appId": "your_app_id",
          "appSecret": "your_app_secret",
          "backendUrl": "http://192.168.10.10:21000",
          "enableEncryption": true,
          "requestTimeout": 30000
        }
      }
    }
  }
}
字段类型默认值说明
appIdstring必填飞函应用 ID
appSecretstring必填飞函应用密钥
backendUrlstring必填飞函服务端地址
enabledbooleantrue启用/停用此账号
enableEncryptionbooleantrue启用 OpenClaw 与飞函服务端之间的加密通信
requestTimeoutnumber30000等待飞函服务端响应的超时时间(毫秒)

第 7 步 — 验证机器人

插件安装完成后,打开飞函客户端,在搜索栏中搜索 OpenClaw,你应该能在通讯录中看到它。点击即可发起对话,验证机器人是否正常工作。

在飞函客户端中搜索 OpenClaw 机器人

你已成功部署 OpenClaw 插件。团队成员现在可以在飞函客户端中与 OpenClaw 机器人进行交互了。