debox-openclaw-plugin

DeBox 的 OpenClaw channel plugin（channel id: debox）。

目标是提供更原生、更稳定的 gateway 接入版本：

• 使用 channels["debox"] 账户配置模型
• 通过 gateway.startAccount 托管生命周期
• 用 DeBox Bot API 长轮询收消息
• 通过 OpenClaw gateway 原生消息管线处理消息
• 支持 OpenClaw 主动发消息到 DeBox
• 按会话串行处理，降低重复回复和乱序风险

目录

• index.ts: OpenClaw 插件入口
• src/channel.ts: channel plugin 定义
• src/gateway.ts: 轮询、去重、排队、接入 OpenClaw reply dispatcher
• src/outbound.ts: 主动发消息
• src/debox-sdk/*: 从现有 debox_plugin 整理出的 DeBox SDK
• skills/debox-cron/SKILL.md: DeBox 定时提醒技能（cron 调度 + 正确投递参数）
• skills/debox-message/SKILL.md: DeBox 文本消息投递技能（目标地址与能力边界）

配置

推荐放在 ~/.openclaw/openclaw.json:

{
  "channels": {
    "debox": {
      "enabled": true,
      "token": "YOUR_DEBOX_BOT_TOKEN",
      "apiHost": "https://open.debox.pro",
      "timeout": 30,
      "pollIntervalMs": 500,
      "maxProcessingTimeMs": 60000
    }
  }
}

也支持命名账户：

{
  "channels": {
    "debox": {
      "accounts": {
        "work": {
          "enabled": true,
          "token": "YOUR_DEBOX_BOT_TOKEN"
        }
      }
    }
  }
}

OpenClaw 处理链路

插件通过 runtime 的 channel.reply.dispatchReplyWithBufferedBlockDispatcher 进入 OpenClaw 原生处理链路，插件内不再维护独立 /v1/responses 调用分支。

安装

在插件目录执行：

npm install
npm run build
openclaw plugins install .
openclaw channels add --channel debox --token "YOUR_DEBOX_BOT_TOKEN"

发布到 npm 市场

发布步骤见 PUBLISH.md。

快速发布命令：

./publishnpm.sh

与旧版 debox_plugin 的差异

• 配置模型统一为 channels.debox 账户结构，不再混用 channels 和 plugins.entries
• 生命周期走 OpenClaw channel gateway，而不是在入口里自行拼路由和全局状态
• 轮询加入 update 去重、错误退避、按 chat 串行队列
• 主动发送走 channel outbound，而不是只支持入站轮询回复
• 文档和目录结构可直接继续迭代