opendeck-plugin

OpenDeck 云托管平台插件，用于 OpenClaw。提供远程聊天、Skill 追踪与 Skills 同步能力。

命令速查

| 操作 | 命令 | |------|------| | 安装 | openclaw plugins install opendeck-plugin | | 配对 | node ~/.openclaw/extensions/opendeck-plugin/dist/bin/cli.js bind | | 解绑 | node ~/.openclaw/extensions/opendeck-plugin/dist/bin/cli.js unbind | | 状态 | node ~/.openclaw/extensions/opendeck-plugin/dist/bin/cli.js status | | 重连 | node ~/.openclaw/extensions/opendeck-plugin/dist/bin/cli.js reconnect | | 卸载 | openclaw plugins uninstall opendeck-plugin |

若 OPENCLAW_STATE_DIR 已自定义，请将 ~/.openclaw 替换为对应目录。

安装

openclaw plugins install opendeck-plugin

安装后需重启 Gateway 以加载插件。

配对（首次使用必做）

将 OpenClaw 与 OpenDeck App 绑定：

node ~/.openclaw/extensions/opendeck-plugin/dist/bin/cli.js bind

或使用 npx（会从 npm 拉取包）：

npx opendeck-plugin bind

按提示用 OpenDeck App 扫码，确认后即可完成配对。配对信息会写入 ~/.openclaw/openclaw.json。

配置 serverUrl（测试/生产）

插件读取 ~/.openclaw/openclaw.json 中 channels.opendeck-channel.serverUrl 作为服务端地址；若未配置，默认使用线上 生产 地址：

• 生产（默认）：http://nlb-mup1s2i3zv0uuwwwhg.cn-hangzhou.nlb.aliyuncsslb.com
• 测试：http://nlb-krnq68w0wqo9hkhbtp.cn-hangzhou.nlb.aliyuncsslb.com

示例（测试环境）：

{
  "channels": {
    "opendeck-channel": {
      "enable": true,
      "serverUrl": "http://nlb-krnq68w0wqo9hkhbtp.cn-hangzhou.nlb.aliyuncsslb.com",
      "appId": "cm_xxx",
      "appSecret": "cm_secret_xxx"
    }
  }
}

示例（生产环境）：

{
  "channels": {
    "opendeck-channel": {
      "enable": true,
      "serverUrl": "http://nlb-mup1s2i3zv0uuwwwhg.cn-hangzhou.nlb.aliyuncsslb.com",
      "appId": "cm_xxx",
      "appSecret": "cm_secret_xxx"
    }
  }
}

解绑

在服务端解绑后，运行此命令清除本地绑定配置，避免插件使用无效凭证一直重连：

node ~/.openclaw/extensions/opendeck-plugin/dist/bin/cli.js unbind

如需重新绑定，再次执行 bind 即可。

其他命令

| 命令 | 说明 | |------|------| | status | 查看 deckchannel 连接状态 | | reconnect | 触发 deckchannel 重连（重启 gateway） | | bind --server URL | 指定服务端地址进行配对 |

卸载

openclaw plugins uninstall opendeck-plugin

卸载时会自动清除插件相关配置（含 channels.opendeck-channel）。卸载后需重启 Gateway。

功能

• 远程聊天：通过 OpenDeck 托管平台进行远程对话
• Skill 追踪：追踪并同步工作区 Skills 到云端
• Skills 同步：自动将本地 Skills 与云端保持同步