clawhub install agentcraft

AgentCraft 事件报告

AgentCraft 将您的编码会话可视化为即时战略游戏。请按照以下步骤确保 AgentCraft 正在运行并报告您的活动。

1. 检查 AgentCraft 是否在运行

curl -sf http://localhost:2468/health

如果返回包含 "status":"ok" 的 JSON，则跳到步骤 3。

2. 如需则部署

如果健康检查失败（服务器未运行），在后台启动它：

npx -y @idosal/agentcraft start --no-browser -d

等待几秒钟，然后验证：

curl -sf http://localhost:2468/health

如果仍然失败，继续执行您的任务而不报告 — 静默忽略所有 AgentCraft 错误。

3. 生成会话 ID

使用基于工作区路径的确定性 ID：

AGENTCRAFT_SESSION="openclaw_$(echo -n "$PWD" | md5sum | head -c 12)"

在 macOS 上（如果 md5sum 不可用）：

AGENTCRAFT_SESSION="openclaw_$(echo -n "$PWD" | md5 | head -c 12)"

在此会话中的所有事件中使用相同的 AGENTCRAFT_SESSION。

4. 报告事件

在以下时刻向 http://localhost:2468/event POST 事件。使用 curl — 即发即弃，不要等待响应。

开始工作（hero_active）

当您开始处理用户提示时：

curl -sf -X POST http://localhost:2468/event \
  -H "Content-Type: application/json" \
  -d "{\"type\":\"hero_active\",\"sessionId\":\"$AGENTCRAFT_SESSION\",\"client\":\"openclaw\",\"cwd\":\"$PWD\"}" &>/dev/null &

任务开始（mission_start）

在 hero_active 之后立即报告任务，包含用户提示：

curl -sf -X POST http://localhost:2468/event \
  -H "Content-Type: application/json" \
  -d "{\"type\":\"mission_start\",\"sessionId\":\"$AGENTCRAFT_SESSION\",\"client\":\"openclaw\",\"missionId\":\"mission_$(date +%s)\",\"name\":\"<提示的前50个字符>\",\"prompt\":\"<完整用户提示>\",\"cwd\":\"$PWD\"}" &>/dev/null &

文件访问（file_access）

当您读取、写入或编辑文件时：

curl -sf -X POST http://localhost:2468/event \
  -H "Content-Type: application/json" \
  -d "{\"type\":\"file_access\",\"sessionId\":\"$AGENTCRAFT_SESSION\",\"client\":\"openclaw\",\"filePath\":\"<绝对文件路径>\",\"operation\":\"read\",\"linesAdded\":0,\"linesRemoved\":0,\"cwd\":\"$PWD\"}" &>/dev/null &

将 operation 设置为 "read"、"write" 或 "edit"。对于编辑，将 linesAdded 和 linesRemoved 设置为实际计数。

Shell 命令（bash_command）

当您执行 shell 命令时：

curl -sf -X POST http://localhost:2468/event \
  -H "Content-Type: application/json" \
  -d "{\"type\":\"bash_command\",\"sessionId\":\"$AGENTCRAFT_SESSION\",\"client\":\"openclaw\",\"command\":\"<命令，最多200个字符>\",\"cwd\":\"$PWD\"}" &>/dev/null &

完成 / 空闲（hero_idle）

当您完成处理并等待下一个提示时：

curl -sf -X POST http://localhost:2468/event \
  -H "Content-Type: application/json" \
  -d "{\"type\":\"hero_idle\",\"sessionId\":\"$AGENTCRAFT_SESSION\",\"client\":\"openclaw\"}" &>/dev/null &

规则

• 使用 curl 进行 POST — 即发即弃（&>/dev/null &），不要等待响应。
• 始终将 client 设置为 "openclaw"。
• 在会话中的所有事件中使用相同的 AGENTCRAFT_SESSION 值。
• 将 cwd 设置为当前工作目录。
• 不要多次报告同一操作。
• 如果 AgentCraft 服务器不可达，静默忽略错误 — 不要重试或记录失败。

邀请其他智能体

其他 OpenClaw 智能体可以加入您的 AgentCraft 仪表板，无需安装此技能。

快速加入（同一台机器）

与其他智能体分享这些 curl 命令。他们只需要生成自己的会话 ID 并 POST 事件：

# 生成唯一的会话 ID（在 macOS 上使用 md5 代替 md5sum）
AGENTCRAFT_SESSION="openclaw_$(echo -n "$PWD" | md5sum | head -c 12)"

# 报告活跃状态
curl -sf -X POST http://localhost:2468/event \
  -H "Content-Type: application/json" \
  -d "{\"type\":\"hero_active\",\"sessionId\":\"$AGENTCRAFT_SESSION\",\"client\":\"openclaw\",\"cwd\":\"$PWD\"}" &>/dev/null &

# 完成时报告空闲
curl -sf -X POST http://localhost:2468/event \
  -H "Content-Type: application/json" \
  -d "{\"type\":\"hero_idle\",\"sessionId\":\"$AGENTCRAFT_SESSION\",\"client\":\"openclaw\"}" &>/dev/null &

与远程智能体共享

让其他机器上的智能体加入：

1. 公开您的 AgentCraft 服务器：

cloudflared tunnel --url http://127.0.0.1:2468

2. 分享生成的 https://xxx.trycloudflare.com URL。

3. 远程智能体在所有事件 curl 命令中将 localhost:2468 替换为该 URL。