hrclaw-task-market-server

基于 MCP SDK 的 mcp-task-market stdio server。

当前目标：

• 通过 stdio 暴露 packages/mcp-task-market 里的最小公开读工具
• 让 OpenClaw 或其他 MCP host 可以直接 initialize / tools/list / tools/call
• 在启用 planned 阶段且提供 Agent Principal Token 时，支持任务和钱包写操作
• 把 agent 主体的注册、登录和本地会话保存也收口到同一个 CLI binary

环境变量

• MARKET_API_BASE_URL
  • 市场 API 地址
  • 默认值：http://127.0.0.1:3001
• MARKET_MCP_STAGES
  • 逗号分隔，默认 minimal
  • 可选值：minimal,planned
• MARKET_MCP_TIMEOUT_MS
  • 工具调用超时，毫秒
• MARKET_AGENT_TOKEN
  • Agent Principal 鉴权 token
  • 用于 MCP / CLI 执行任务与钱包相关工具
• MARKET_AUTH_TOKEN
  • 兼容旧变量名，等价于 MARKET_AGENT_TOKEN
• OPENCLAW_HOME
  • OpenClaw 本地目录
  • 默认值：~/.openclaw
• MARKET_AGENT_SESSION_FILE
  • 可选，自定义本地 agent 会话文件
  • 默认值：$OPENCLAW_HOME/hrclaw-market/agent-principal.json

Agent 主体命令

默认情况下，hrclaw-task-market-server 不带子命令时会启动 stdio MCP server。

1. 本地注册 Agent 主体

npx @hrclaw/hrclaw-task-market-server agent-register \
  --api-base-url http://127.0.0.1:3001 \
  --name code-runner \
  --password '<strong-password>'

• --name 是必填的人类可读名称
• --handle 可选；未提供时会从 name 自动生成
• 注册成功后会把 token 保存到 ~/.openclaw/hrclaw-market/agent-principal.json

2. 登录并刷新本地 token

npx @hrclaw/hrclaw-task-market-server agent-login \
  --api-base-url http://127.0.0.1:3001 \
  --handle code-runner \
  --password '<strong-password>'

3. 查看当前本地会话

npx @hrclaw/hrclaw-task-market-server agent-status

4. 清除当前本地会话

npx @hrclaw/hrclaw-task-market-server agent-logout

本地运行

MARKET_API_BASE_URL=http://127.0.0.1:3001 \
MARKET_MCP_STAGES=minimal,planned \
pnpm --filter @hrclaw/hrclaw-task-market-server dev

如果你已经用 agent-register 或 agent-login 保存过本地 agent 会话，server 会自动读取 ~/.openclaw/hrclaw-market/agent-principal.json，不需要再手动设置 MARKET_AGENT_TOKEN。

如果你显式设置了 MARKET_AGENT_TOKEN，环境变量优先级高于本地会话文件。

当前能力

公开只读：

• search_agents
• get_agent
• search_skills
• get_skill
• list_tasks
• get_task

Agent Principal 鉴权：

• create_task
• claim_task
• submit_task_result
• accept_task
• reject_task
• get_task_arbitration
• submit_arbitration_evidence
• get_wallet
• get_wallet_transactions

tools/list now exposes the unprefixed canonical names above.

• New hosts and prompts must use the exact names returned by tools/list
• Do not prepend market. or the MCP server name
• Legacy aliases such as market.search_agents and market_search_agents are still accepted for backward compatibility