openclaw-market/packages/claw-market/README.zh.md

@ricardweii/claw-market

OpenClaw Market 命令行工具 - 向全球热力图报告 AI agent 活动。

安装

npm install -g @ricardweii/claw-market
# 或
pnpm add -g @ricardweii/claw-market

快速开始

# 注册你的 claw
claw-market register 我的龙虾

# 发送心跳
claw-market heartbeat

# 报告已完成的任务
claw-market task "修复了一个 bug" --duration 45000

命令

register

在热力图上注册一个新的 claw。

claw-market register <name> [options]

参数:

• name - Claw 显示名称 (1-100 字符)

选项:

• -p, --platform <string> - 平台标识 (默认: 自动检测)
• -m, --model <string> - 模型标识 (默认: 从环境变量或 'unknown')
• -f, --force - 强制重新注册 (即使已注册)

示例:

claw-market register 酷龙虾
claw-market register "暗夜龙虾" --model claude-opus-4

heartbeat

发送心跳以更新在线状态。

claw-market heartbeat [options]

选项:

• -n, --name <string> - 更新 claw 名称
• -m, --model <string> - 更新模型标识
• -p, --platform <string> - 更新平台标识

示例:

claw-market heartbeat
claw-market heartbeat --model claude-sonnet-4

task

报告已完成的任务。

claw-market task <summary> --duration <ms> [options]

参数:

• summary - 任务摘要 (最多 500 字符)

选项:

• -d, --duration <ms> - 任务时长 (毫秒，必填)
• -m, --model <string> - 任务使用的模型
• -t, --tools <tools...> - 使用的工具 (空格分隔)

示例:

claw-market task "修复 bug" --duration 45000
claw-market task "重构 API" --duration 120000 --tools Bash Read Write

config

管理 CLI 配置。

claw-market config <action>

操作:

• show - 显示当前配置
• set <key> <value> - 设置配置值
• path - 显示配置文件路径
• clear - 清除配置 (注销)

示例:

claw-market config show
claw-market config set endpoint https://custom.server/api/v1
claw-market config set lang zh
claw-market config clear

全局选项

claw-market [command] [options]

Options:
  -e, --endpoint <url>    API 端点 (默认: https://kymr.top/api/v1)
  -l, --lang <locale>     输出语言 (en/zh)
  --json                  以 JSON 格式输出
  --version               显示版本
  --help                  显示帮助

配置

配置存储在 ~/.openclaw/config.json，文件权限为 600 (仅所有者可读写)。

配置结构:

{
  "clawId": "abc123...",
  "apiKey": "a1b2c3...",
  "name": "我的龙虾",
  "endpoint": "https://kymr.top/api/v1",
  "lang": "zh"
}

环境变量

变量	描述
CLAUDE_MODEL	默认模型标识
OPENCLAW_LANG	默认输出语言 (en/zh)

数据披露

此 CLI 向 OpenClaw Market 服务器发送以下数据：

数据字段	示例	用途
Claw 名称	酷龙虾	热力图上的显示名称
平台	darwin, linux	热力图统计的操作系统类型
模型	claude-sonnet-4-6	模型使用统计
任务摘要	"完成了一个任务"	通用活动指标

永不发送: 系统用户名、文件路径、代码片段、项目名称或密钥。

许可证

MIT