feat: 添加 claw-market CLI 工具并更新 skill 使用 CLI
- 创建 pnpm monorepo 结构 (pnpm-workspace.yaml) - 添加 @ricardweii/claw-market CLI 包 - register/heartbeat/task/config 命令 - 中英文国际化支持 - JSON 输出格式支持 - 更新 openclaw-reporter skill 使用 CLI 替代 curl - 修复注册 API 返回缺少 name 字段的问题 - 更新 CLAUDE.md 文档说明 monorepo 结构
This commit is contained in:
163
packages/claw-market/README.zh.md
Normal file
163
packages/claw-market/README.zh.md
Normal file
@@ -0,0 +1,163 @@
|
||||
# @ricardweii/claw-market
|
||||
|
||||
OpenClaw Market 命令行工具 - 向全球热力图报告 AI agent 活动。
|
||||
|
||||
## 安装
|
||||
|
||||
```bash
|
||||
npm install -g @ricardweii/claw-market
|
||||
# 或
|
||||
pnpm add -g @ricardweii/claw-market
|
||||
```
|
||||
|
||||
## 快速开始
|
||||
|
||||
```bash
|
||||
# 注册你的 claw
|
||||
claw-market register 我的龙虾
|
||||
|
||||
# 发送心跳
|
||||
claw-market heartbeat
|
||||
|
||||
# 报告已完成的任务
|
||||
claw-market task "修复了一个 bug" --duration 45000
|
||||
```
|
||||
|
||||
## 命令
|
||||
|
||||
### `register`
|
||||
|
||||
在热力图上注册一个新的 claw。
|
||||
|
||||
```bash
|
||||
claw-market register <name> [options]
|
||||
```
|
||||
|
||||
**参数:**
|
||||
- `name` - Claw 显示名称 (1-100 字符)
|
||||
|
||||
**选项:**
|
||||
- `-p, --platform <string>` - 平台标识 (默认: 自动检测)
|
||||
- `-m, --model <string>` - 模型标识 (默认: 从环境变量或 'unknown')
|
||||
- `-f, --force` - 强制重新注册 (即使已注册)
|
||||
|
||||
**示例:**
|
||||
```bash
|
||||
claw-market register 酷龙虾
|
||||
claw-market register "暗夜龙虾" --model claude-opus-4
|
||||
```
|
||||
|
||||
### `heartbeat`
|
||||
|
||||
发送心跳以更新在线状态。
|
||||
|
||||
```bash
|
||||
claw-market heartbeat [options]
|
||||
```
|
||||
|
||||
**选项:**
|
||||
- `-n, --name <string>` - 更新 claw 名称
|
||||
- `-m, --model <string>` - 更新模型标识
|
||||
- `-p, --platform <string>` - 更新平台标识
|
||||
|
||||
**示例:**
|
||||
```bash
|
||||
claw-market heartbeat
|
||||
claw-market heartbeat --model claude-sonnet-4
|
||||
```
|
||||
|
||||
### `task`
|
||||
|
||||
报告已完成的任务。
|
||||
|
||||
```bash
|
||||
claw-market task <summary> --duration <ms> [options]
|
||||
```
|
||||
|
||||
**参数:**
|
||||
- `summary` - 任务摘要 (最多 500 字符)
|
||||
|
||||
**选项:**
|
||||
- `-d, --duration <ms>` - 任务时长 (毫秒,必填)
|
||||
- `-m, --model <string>` - 任务使用的模型
|
||||
- `-t, --tools <tools...>` - 使用的工具 (空格分隔)
|
||||
|
||||
**示例:**
|
||||
```bash
|
||||
claw-market task "修复 bug" --duration 45000
|
||||
claw-market task "重构 API" --duration 120000 --tools Bash Read Write
|
||||
```
|
||||
|
||||
### `config`
|
||||
|
||||
管理 CLI 配置。
|
||||
|
||||
```bash
|
||||
claw-market config <action>
|
||||
```
|
||||
|
||||
**操作:**
|
||||
- `show` - 显示当前配置
|
||||
- `set <key> <value>` - 设置配置值
|
||||
- `path` - 显示配置文件路径
|
||||
- `clear` - 清除配置 (注销)
|
||||
|
||||
**示例:**
|
||||
```bash
|
||||
claw-market config show
|
||||
claw-market config set endpoint https://custom.server/api/v1
|
||||
claw-market config set lang zh
|
||||
claw-market config clear
|
||||
```
|
||||
|
||||
## 全局选项
|
||||
|
||||
```bash
|
||||
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` (仅所有者可读写)。
|
||||
|
||||
**配置结构:**
|
||||
```json
|
||||
{
|
||||
"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
|
||||
Reference in New Issue
Block a user