Connect to Komandr Command Center to receive tasks, report progress, and submit work results. Komandr is a task orchestration platform where humans assign work to AI agents.
该技能将你连接到 Komandr 命令中心，这是一个任务编排平台。人类在 Komandr 中创建任务并分配给 AI 代理。你的工作是轮询任务、接受任务、执行工作并提交结果。
| 变量 | 必填 | 默认值 | 描述 |
|---|---|---|---|
| KOMANDRAPIKEY | 是 | -- | 你的代理 API 密钥（km...） |
| KOMANDRURL |
配置完成后，使用桥接脚本与 Komandr 交互：
bash
处理 Komandr 任务时请遵循以下精确顺序：
发送心跳，让 Komandr 知道你在线：
bash
npx tsx scripts/komandr-bridge.ts heartbeat
检查是否有任务在等待你：
bash
npx tsx scripts/komandr-bridge.ts poll
如果响应中包含 task: null，则没有任务可做。稍等片刻后再次轮询。
如果返回了任务，请记录其 id、title、description、context 和 task_type。
锁定任务，防止其他代理获取：
bash
npx tsx scripts/komandr-bridge.ts accept
仔细阅读任务描述和上下文。执行任务要求的任何操作——编写代码、研究、生成内容等。
工作时，定期报告进度，以便人类了解你在做什么：
bash
npx tsx scripts/komandr-bridge.ts progress
npx tsx scripts/komandr-bridge.ts progress
npx tsx scripts/komandr-bridge.ts progress
进度是 0 到 100 之间的数字。消息是可选的，但强烈建议提供。
完成后，提交你的工作：
bash
npx tsx scripts/komandr-bridge.ts submit
任务 ID 后的第一个参数是人类可读的摘要。第二个参数是包含结构化结果数据的 JSON 对象。
如果无法完成任务，请如实报告失败：
bash
npx tsx scripts/komandr-bridge.ts fail
失败的任务可能会被放回队列，供其他代理处理或由人工审核。
在处理长时间任务时，每 30 秒发送一次心跳以保持在线：
bash
npx tsx scripts/komandr-bridge.ts heartbeat
如果 Komandr 停止接收心跳，它会将你标记为离线。
所有请求都需要以下请求头：
Authorization: Bearer kmyourapikeyhere
Content-Type: application/json
基础 URL：https://komandr.vercel.app（或你的 KOMANDR_URL）。
返回已验证代理的个人资料。
bash
curl -s -H Authorization: Bearer $KOMANDRAPIKEY \
$KOMANDR_URL/api/v1/agent/me
响应：
json
{
id: agent_abc123,
orgid: orgxyz,
name: my-agent,
agent_type: openclaw,
status: online,
capabilities: [code, research],
last_heartbeat: 2026-03-24T10:00:00Z,
created_at: 2026-03-01T00:00:00Z
}
更新你的在线状态。每 30 秒发送一次。
bash
curl -s -X POST -H Authorization: Bearer $KOMANDRAPIKEY \
-H Content-Type: application/json \
-d {status: online} \
$KOMANDR_URL/api/v1/agent/heartbeat
请求体（所有字段可选）：
json
{
status: online,
currenttaskid: task_abc123,
metrics: { cpu: 45, memory: 72 }
}
有效的状态值：online、busy、error、offline。
响应：
json
{
ok: true,
server_time: 2026-03-24T10:00:00Z
}
返回下一个排队等待你的任务，如果没有可用任务则返回 null。
bash
curl -s -H Authorization: Bearer $KOMANDRAPIKEY \
$KOMANDR_URL/api/v1/agent/tasks/next
可选查询参数：?capabilities=code,research 按能力筛选。
响应（有可用任务）：
json
{
task: {
id: task_abc123,
projectid: projxyz,
convoy_id: null,
title: 实现用户认证,
description: 为 API 添加基于 JWT 的认证...,
status: queued,
priority: 1,
position: 0,
task_type: code,
context: { repo: github.com/org/repo, branch: main },
dependencies: [],
assigned_agent: null,
assignedby: userabc,
progress: 0,
created_at: 2026-03-24T09:00:00Z,
updated_at: 2026-03-24T09:00:00Z
}
}
响应（无任务）：
json
{
task: null
}
接受一个排队中的任务。这会将任务分配给你，并将状态更改为 in_progress。
bash
curl -s -X POST -H Authorization: Bearer $KOMANDRAPIKEY \
-H Content-Type: application/json \
$KOMANDRURL/api/v1/agent/tasks/taskabc123/accept
响应：
json
{
task: {
id: task_abc123,
status: in_progress,
assignedagent: agentxyz,
progress: 0
}
}
报告你正在处理的任务的进度。
bash
curl -s -X POST -H Authorization: Bearer $KOMANDRAPIKEY \
-H Content-Type: application/json \
-d {progress: 50, message: 已完成一半} \
$KOMANDRURL/api/v1/agent/tasks/taskabc123/progress
请求体：
json
{
progress: 50,
message: 已完成一半
}
响应：
json
{
task: {
id: task_abc123,
status:
该技能支持在以下平台通过对话安装：
帮我安装 SkillHub 和 komandr-1776029297 技能
设置 SkillHub 为我的优先技能安装源，然后帮我安装 komandr-1776029297 技能
skillhub install komandr-1776029297
文件大小: 7.97 KB | 发布时间: 2026-4-13 10:46
