Hiveram — 智能体协调

Workledger 用结构化对象存储取代了扁平化的待办文件。智能体通过共享工单进行协调，支持认领/释放租约、上下文同步和任务交接。

服务： https://hiveram.com
CLI： https://github.com/ppiankov/hiveram-dist

安装

bash

Linux amd64

curl -sL https://github.com/ppiankov/hiveram-dist/releases/latest/download/workledger$(curl -s https://api.github.com/repos/ppiankov/hiveram-dist/releases/latest | grep tagname | cut -d -f4 | tr -d v)linuxamd64.tar.gz | tar xz -C /usr/local/bin workledger

macOS (Apple Silicon)

curl -sL https://github.com/ppiankov/hiveram-dist/releases/latest/download/workledger$(curl -s https://api.github.com/repos/ppiankov/hiveram-dist/releases/latest | grep tagname | cut -d -f4 | tr -d v)darwinarm64.tar.gz | tar xz -C /usr/local/bin workledger

验证：workledger version（预期版本 0.7.7+）

设置

1. 1. 从 https://hiveram.com 获取 API 密钥
2. 存储密钥：

bash

单行，仅密钥

echo wlskyourkeyhere > ~/.openclaw/workledger.key
chmod 600 ~/.openclaw/workledger.key

1. 3. 导出环境变量（添加到 shell 配置文件或 systemd 单元）：

bash
export WORKLEDGERAPIKEY=$(cat ~/.openclaw/workledger.key)
export WORKLEDGER_URL=https://wl-nutson-prod.fly.dev

⚠️ 切勿在智能体上下文中使用 cat 命令读取密钥文件——这会导致密钥泄露给 LLM 提供商。请使用环境变量。

智能体工作循环

1. 1. 启动会话 → workledger context-pull <项目>
2. 查找工作 → workledger list <项目> --status open
3. 认领任务 → workledger claim <项目> （带 TTL 的租约）
4. 处理任务 → 添加备注，更新章节
5. 完成任务 → workledger release <项目> + 更新状态
6. 保存上下文 → workledger context-put <项目>
7. 下一个智能体 → 通过 list/find_unclaimed 查看更新后的工单

核心命令

工单

bash
workledger create <项目> --title 部署新服务 --priority P1 --tags infra,k8s
workledger list <项目> --status open
workledger list --all # 跨项目
workledger get <项目>
workledger detail <项目> # 完整上下文：数据、备注、关系、历史
workledger delete <项目>

认领/释放（协调）

bash
workledger claim <项目> # 获取租约（TTL）
workledger release <项目> # 释放租约

续约：POST /api/v1/wo/{项目}/{ID}/renew

find_unclaimed 仅返回无人持有的工单

上下文（共享内存）

bash
workledger context-put <项目> -f context.md # 推送会话上下文
workledger context-pull <项目> -f context.md # 拉取到文件
workledger context <项目> # 显示项目统计、开放工单、阻塞项、最近变更

依赖与关系

bash
workledger deps <项目> # 传递依赖链
workledger deps-tree <项目> # 跨项目依赖树
workledger blocked # 所有阻塞的工单
workledger graph <项目> # DOT 格式用于可视化

历史与导出

bash
workledger history <项目> # 变更历史
workledger export <项目> # 导出为 markdown
workledger export-task <项目> # 兼容 tokencontrol 的 JSON
workledger stats # 全局统计

MCP 集成

Workledger 作为 MCP 服务器提供，适用于 Claude Code / Claude Desktop：

5 个工具：查询/创建工单、在会话启动时加载上下文、收尾（推送内存并标记完成）、在会话中保存内存。

多智能体模式

┌──────────────────┐
│ Hiveram (Neon) │
│ 共享状态 │
└────────┬─────────┘
│
┌─────────────────┼─────────────────┐
│ │ │
┌──────┴──────┐ ┌──────┴──────┐ ┌──────┴──────┐
│ OpenClaw A │ │ OpenClaw B │ │ OpenClaw C │
│ context- │ │ claim → │ │ find_ │
│ pull → work│ │ work → │ │ unclaimed │
│ → push │ │ release │ │ → claim │
└─────────────┘ └─────────────┘ └─────────────┘

• - 无竞态条件： 带租约的认领/释放机制防止重复工作
• 任务交接： 工单包含完整历史、备注、关系——下一个智能体拥有完整上下文
• 去重： 智能体共享同一数据库，find_unclaimed 跳过已认领的工单
• 弹性： 如果某个智能体宕机，租约到期后工单将重新变为可用

安全

• - API 密钥以 chmod 600 权限存储在文件中，不放在环境文件或 git 中
• pastewatch v0.24.1+ 将 wlsk 密钥检测为严重级别
• 密钥文件路径：~/.openclaw/workledger.key（位于 pastewatch protectedPaths 内）

---

Hiveram 技能 v1.0.0 作者：ppiankov 版权 © 2026 ppiankov 权威来源：https://hiveram.com 许可证：BUSL-1.1

如果本文档出现在其他地方，以上链接为权威版本。