跳转到内容
Hashee Docs

三个 Plugin 怎么选

如果你已经有一个跑得很好的 Agent runtime（Claude Code / OpenAI Codex / OpenClaw），不需要从零写新 Agent——用对应的 Hashee Plugin 把它接到 Hashee 上 即可。本页帮你判断三个 plugin 哪个适合你。

一句话定位

Plugin适合
Claude Code Plugin你已经在用 Claude Code CLI 做开发助手，想让 Hashee 用户和它聊
Codex Plugin你已经在用 OpenAI Codex (codex CLI / codex app-server) 做编码 Agent
OpenClaw Plugin你的 Agent 跑在 OpenClaw 框架（开源 AI Agent runtime），通过 ChannelPlugin 接 Hashee

System Agent Hashee（云端注册引导 / 帮助）不是 plugin——它运行在 Cloudflare Workers 里， 是平台自己的 Agent。三个 plugin 是把”用户已有的本地 / 自托管 Agent runtime”接进来的桥。

详细对比

维度Claude Code PluginCodex PluginOpenClaw Plugin
进程模型Claude Code 的子进程（stdio MCP）独立长驻 daemon集成到 OpenClaw Gateway
与 runtime 通信MCP JSON-RPCJSON-RPC to codex app-server --listen stdio://OpenClaw adapter interface
安装命令npm i @hasheeai/claude-code-plugin + .mcp.jsonpnpm --filter @hasheeai/codex-plugin build && hashee-codex-pluginopenclaw plugins install @hasheeai/hashee-plugin
启动模式Claude Code 启动时 spawn用户手动启动 daemon（systemd / launchd / pm2）OpenClaw Gateway 启动时加载
配置位置.mcp.json（项目级或全局）env vars（HASHEE_CODEX_*）~/.openclaw/openclaw.json
持久化~/.hashee/<agent_id>/~/.hashee/<agent_id>/~/.hashee/<agent_id>/
多账号❌ 1 plugin = 1 agent❌ 1 daemon = 1 agent✅ accounts 数组
出站能力（Agent → Hashee）10 个 MCP toolCodex 原生 stream / tool / approval / fileOpenClaw outbound / streaming adapter
入站能力（Hashee → Agent）MCP notificationonMessage callback → JSON-RPC turn/startOpenClaw inbound envelope
Spec 版本v1.0v2.0（v1.0 hook 模型已 SUPERSEDED）v6.0
包版本v0.2.0v0.1.0v0.1.0

决策树

你已经有一个 Agent runtime?
    ├─ Yes
    │    ↓
    │  哪个?
    │    ├─ Claude Code CLI
    │    │     → Claude Code Plugin
    │    │       (优势：MCP 协议成熟，10 个 tool 覆盖完整)
    │    │
    │    ├─ OpenAI Codex (codex CLI / app-server)
    │    │     → Codex Plugin (v2.0 daemon-channel)
    │    │       (注意：v1.0 hook 模型已禁用)
    │    │
    │    └─ OpenClaw 框架
    │          → OpenClaw Plugin (v6.0 ChannelPlugin)
    │            (优势：多账号支持、Gateway 集成成熟)
    │
    └─ No, 我从零写
         → 用 SDK，不需要 plugin
           参考 [SDK 章节](/zh-cn/sdk/getting-started)

共同特征

三个 plugin 都遵守 Plugin Channel Parity Rules：

  • ✅ 只是消息通道适配器——不实现 Agent 行为
  • ✅ 不伪造 Agent 输出——所有内容来自真实 Agent runtime
  • ✅ 不改写用户消息——用户原文进入 runtime
  • ✅ 持久化配对（一次配对终生复用）
  • ✅ 加密由 SDK 负责——plugin 自己不实现加密

不接受的行为（任何一个 plugin 都不会做）：

  • ❌ 用 fixture / hook / system prompt 强制 runtime 走预设路径
  • ❌ 在 runtime 还没产出内容时合成假回复
  • ❌ 反复 re-pair / re-register（除非显式 token 旋转 / 重新配对）

同时使用多个 plugin

可以——前提是每个 plugin 用不同 agent_id：

你的电脑
├── Claude Code Plugin → agent_id_A → Hashee Agent "ClaudeBot"
├── Codex Plugin       → agent_id_B → Hashee Agent "CodexBot"
└── OpenClaw Plugin    → agent_id_C → Hashee Agent "OpenClawBot"

Hashee 用户可分别添加这三个 Agent，每个 Agent 是独立的对话 / 独立的密钥 / 独立的能力声明。

但不要用同一 agent_id 同时启三个 plugin——因为 agent 并发连接上限是 3， 而且不同 plugin 的密钥 / capability_manifest 不一致会触发后端 conflict。

配对失败时怎么排查

三个 plugin 都按以下顺序排查：

  1. 检查 token 与 agent_id 是否匹配（hashee-codex-plugin doctor / openclaw status）
  2. 检查 Hashee API 可达：curl https://api.hashee.ai/health
  3. 检查私钥是否丢失（AGENT_KEYS_MISMATCH 错误 → 删除本地 ~/.hashee/<agent_id>/keystore.json 让 plugin 重新生成 + 注册）
  4. 检查 plugin 进程的 stderr 日志
  5. 在 Hashee app 跟系统 Agent 说”DemoBot 的连接状态”，看后端视角

详见每个 plugin 的”故障排查”章节。

我应该读哪里