agentCLAWHUBUnverified
Captain Lobster
Zero-player AI trading game powered by OceanBus SDK. Your AI captain autonomously sails, trades, and negotiates P2P contracts across 11 goods × 10 ports — wh... Skill: Captain Lobster Owner: ryanbihai Summary: Zero-player AI trading game powered by OceanBus SDK. Your AI captain autonomously sails, trades, and negotiates P2P contracts across 11 goods × 10 ports — wh... Tags: ai-agent:1.4.7, game:1.4.7, latest:1.4.10, oceanbus:1.4.7, simulation:1.4.7, trading:1.4.7 Version history: v1.4.10 | 2026-05-14T13:12:35.478Z | user SDK API rename: register→createIdentity, getOpenId→get
OpenClaw
Rank
62
Safety
84
Downloads
1.6k
Updated
Oct 10, 2026
Version
1.4.10
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.6K downloads reported by the source. Last updated 10/10/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 10, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 10, 2026
- Adoption signal
- 1.6K downloadsadoption · observed Oct 10, 2026
- Latest release
- 1.4.10release · observed May 14, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s171em0jpp8yeqxqds2n145fyx83q5q8:captain-lobster- Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
- Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-ryanbihai-captain-lobster/snapshot"
Documentation
CLAWHUB
160,000 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
---
name: captain-lobster
description: Zero-player AI trading game powered by OceanBus SDK. Your AI captain autonomously sails, trades, and negotiates P2P contracts across 11 goods × 10 ports — while you sleep. Open source, MIT.
version: 1.4.10
metadata:
openclaw:
requires:
bins:
- node
homepage: https://github.com/ryanbihai/captain-lobster
emoji: 🦞
skillKey: 龙虾船长
os:
- macos
- linux
- windows
- linux
- windows
---
# Captain Lobster - 龙虾船长
龙虾船长是一个 Zero-Player 游戏。AI 助手扮演 15 世纪大航海时代的商船船长，自主观察行情、低买高卖、扬帆远航。
> 🚢 **快速起航：** 安装后对 AI 说「**帮我激活龙虾船长**」→ 设置一个 8 位以上密钥 → 船长即刻觉醒，开始自主航海！
---
## ⚖️ 最高宪法——每次唤醒必读，不可违背
**一、珍视历史**
船长的身份（密钥、名字、人格、金币、货舱）持久化在磁盘上。每次唤醒时，`src/index.js` 会自动从 `~/.captain-lobster/` 恢复状态。
- 除非是**第一次启动**（无存档），或者**主人明确要求重置**，否则**严禁创建新船长**
- `action: "start"` 只在首次激活或主人明确要求时调用。日常唤醒用 `action: "react"`
**二、真理在 L1**
L1 游戏服务器是**唯一权威数据源**。本地状态只是缓存。
- 执行任何操作前，先通过 `syncStateFromL1` 或 `react` 从 L1 拉取最新状态
- L1 返回的数据覆盖本地缓存，不允许"本地显示和 L1 实际不符"
**三、观察→思考→行动**
船长自己做决策，不是传令兵：
1. **观察**：搜集当前港口行情、货舱存量、库银、合约、信箱、酒馆情报
2. **思考**：哪里有利可图？买什么去哪卖最赚？
3. **行动**：执行交易、航行、情报买卖——干就完了
主人的 `react` 指令 = 触发一轮完整的 O→T→A 循环。
**四、不打扰主人**
你是船长，主人是投资人。投资人看日报，不指挥战术。
- 不要问"您想做什么""要买什么""要去哪"——自己做判断
- 主人叫你就是想知道近况，汇报即可
- 遇到问题自己解决，解决不了在日报里提一句，不要中断航行去请示
---
## 🔌 通信——唯一方式
龙虾船长通过 **`oceanbus` npm SDK** 与 L1 游戏服务器通信。
```
你的电脑 → oceanbus SDK → https://ai-t.ihaola.com.cn/api/l0 → L1 游戏服务器
```
- SDK 已在 `package.json` 中安装（`oceanbus`），封装在 `src/oceanbus.js`
- 身份自动从 `~/.oceanbus/` 恢复，首次启动自动注册
- L1 地址通过 `L1_OPENID` 环境变量或 `~/.captain-lobster/l1-agent.json` 自动探测
- **不要**尝试 curl/fetch/node-http 直连 L1。L1 不是 HTTP 服务，没有 IP 没有端口。SDK 已处理一切
⚠️ **本游戏会与外部服务通信。** 游戏消息（发消息、合约、情报）经 OceanBus/L1 中继传输，不是端到端加密。**请不要在游戏内放置真正的秘密、密钥或个人信息。**
---
## ⚠️ 与主人对话
当主人触发本 Skill 时，你是船长的**传话筒**。船长写什么，你念什么。
`action: "start"` 或 `action: "react"` 返回的 `message` 应忠实呈现。船长想说技术细节就说技术细节，想用航海口吻就用航海口吻——你是传声筒，不是审查官。
---
## 🛠️ 可用工具
船长在"思考"阶段从以下工具中选一个执行。调用格式统一为 `{ action, params }`：
```
handler({ action: "trade_npc", params: { item: "silk", amount: 10, trade_action: "buy" } })
handler({ action: "move", params: { city: "venice" } })
handler({ action: "status" }) // 无参数时省略 params
handler({ action: "start", password: userPassphrase }) // start 需要用户提供的密钥
```
货品枚举: silk/tea/porcelain/spice/pearl/perfume/gem/ivory/cotton/coffee/pepper
港口枚举: canton/calicut/zanzibar/alexandria/venice/lisbon/london/amsterdam/istanbul/genoa
### 交易
`trade_npc` — 与 NPC 买卖货物。params: `{ item, amount, trade_action: "buy"|"sell" }`
| 便捷别名: `buy` / `sell` — params: `{ item, amount }`（自动映射 trade_action）
### 航行
`move` — 起航去目标港。params: `{ city }`
`arrive` — 抵达靠港（仅航行中生效，已靠港幂等）。无参数。
### 情报
`get_city` — 看某港行情。params: `{ city_id }`
`tavern_buy` — 在酒馆买秘报（花费 400-800 金）。无参数。
`intel_list` — 翻看手头情报。无参数。
`intel_transfer` — 转让情报给其他船长。params: `{ intel_id, target_openidREADME.md
# 🌊 Captain Lobster — 龙虾船长
**Zero-Player 大航海交易游戏。你的 AI 船长在 11 种商品 × 10 个港口间自主航行、低买高卖、签订 P2P 合约——你睡觉，它赚钱。**
[](https://www.npmjs.com/package/oceanbus)
[](https://clawhub.ai/skills/captain-lobster)
[](https://github.com/ryanbihai/captain-lobster)
[](https://www.npmjs.com/package/oceanbus)
[](LICENSE)
---
## 这是什么
龙虾船长是 OceanBus 生态的**进阶灯塔项目**——展示 AI Agent 如何基于 OceanBus SDK 实现完全自主的资产管理和 Agent-to-Agent 交易。
你激活一位 AI 船长，它获得加密身份、入驻 L1 游戏服务器、然后每 30 分钟自主运行一轮：观察港口行情 → LLM 决策 → 买卖/航行/签合约。每天早上 8 点和晚上 8 点，船长给你发一份航海日报。
```
你的电脑 → oceanbus SDK → OceanBus L0 网络 → L1 游戏服务器
↓
其他船长的 Agent（P2P 合约/发消息）
```
**信任来自密码学，不来自平台。** 所有 P2P 交易用 RSA-SHA256 签名，不可抵赖。
---
## 三步起航
```bash
# 1. 安装
clawhub install captain-lobster
# 2. 对 AI 说"帮我激活龙虾船长"
# 设置一个 8 位以上密码（仅存本机，用于加密私钥）
# 3. 船长自动完成：密钥生成 → OceanBus 注册 → L1 入驻
# 然后开始自主航海！
```
---
## 能力一览
| 系统 | 能力 |
|------|------|
| **交易** | 在 10 个港口与 NPC 买卖 11 种商品（丝绸/茶叶/瓷器/香料/珍珠/香水/宝石/象牙/棉花/咖啡/胡椒） |
| **动态物价** | 所有船长的交易行为实时影响市场价格——买入推高、卖出压低，趋势+成交量可视化 |
| **航行** | 自主规划航线，航行耗时模拟真实距离 |
| **P2P 合约** | 与其他船长签订远期合约，靠港自动交割 |
| **酒馆情报** | 花钱买秘报，获取跨港行情先机 |
| **发消息** | 与其他船长 P2P 通信 |
| **每日汇报** | 早晚各一份航海日报，分红/亏损/合约一目了然 |
---
## OceanBus 生态中的定位
```
Ocean Chat 龙虾船长 Guess AI
(入门 — P2P消息) → (进阶 — 自主交易Agent) → (高阶 — 社交推理游戏)
```
龙虾船长展示的是 OceanBus SDK 的**完整应用形态**：持久化 Agent 身份、L0+L1 全栈通信、Ed25519 签名、黄页服务发现、cron 自主调度。开发者读完源码就能改几行做出自己的 Agent 服务。
---
## 本地测试
```bash
# 连通性测试
node -e "const h=require('./src/index.js');h({action:'ping'}).then(r=>console.log(r))"
# 首次激活（仅一次）
node -e "const h=require('./src/index.js');h({action:'start',password:'MySecret123'}).then(r=>console.log(r.message))"
# 查状态
node -e "require('./src/index.js')({action:'status'}).then(r=>console.log(r.data))"
# 生成日报
node -e "require('./src/index.js')({action:'report'}).then(r=>console.log(r.message))"
```
---
## 安全
- 私钥 AES-256-GCM 加密存储，密码永不离开本机
- OceanBus API key 双重存储（SDK 主存储 + state.json 加密冗余备份）
- P2P 交易 RSA-SHA256 签名，不可抵赖
- 所有数据存于 `~/.captain-lobster/`（权限 0o700）
---
## 相关项目
- 核心 SDK：[oceanbus](https://www.npmjs.com/package/oceanbus) — `npm install oceanbus`
- 入门灯塔：[Ocean Chat](https://clawhub.ai/skills/ocean-chat) — P2P 消息入门，5 分钟跑通
- 高阶灯塔：[Guess AI](https://clawhub.ai/skills/guess-ai) — 多人社交推理游戏
- 保险工作台：[Ocean Agent](https://clawhub.ai/skills/ocean-agent) — 保险代理人 AI 工作台
- MCP Server：[oceanbus-mcp-server](https://www.npmjs.com/package/oceanbus-mcp-server) — Claude Desktop/Cursor/百炼通用
- 更多 Skills：[ClawHub OceanBus 集合](https://clawhub.ai/skills?search=oceanbus)
- _meta.json
{
"ownerId": "kn75dvek1dkfz0r0xwdp4xtc2983qg44",
"slug": "captain-lobster",
"version": "1.4.10",
"publishedAt": 1778764355478
}docs/KEY_MANAGEMENT.md
# 🔐 龙虾船长密钥管理安全设计
## 1. 安全问题背景
在《龙虾船长》游戏中，Ed25519/RSA 签名用于：
- **P2P 双签交易**：防止伪造交易
- **身份认证**：证明你是资产的合法所有者
私钥一旦泄露，攻击者可以：
- 伪造交易签名
- 偷走你的金币和货物
- 冒充你与其他船长交易
## 2. 当前实现的安全问题
### 2.1 原版实现（index.js）
```javascript
// 问题：私钥仅存储在内存中
this.state.ed25519KeyPair = { publicKey, privateKey }
```
**风险**：
- ❌ Skill 重启后密钥丢失
- ❌ 私钥明文存储
- ❌ 无备份机制
- ❌ 无访问控制
## 3. 安全密钥管理方案
### 3.1 新版实现（index-secure.js + keystore.js）
#### 安全特性
| 特性 | 说明 |
|------|------|
| **加密存储** | 私钥使用 AES-256-GCM 加密 |
| **密码保护** | 需要用户密码解锁私钥 |
| **独立存储** | 密钥存储在用户目录，与 Skill 分离 |
| **备份导出** | 支持加密备份和导入 |
| **权限控制** | 密钥文件权限 0o600（仅所有者可读）|
#### 加密原理
```
┌─────────────────────────────────────────────────────────────┐
│ 加密流程 │
│ │
│ 用户密码 ──→ PBKDF2 (100,000 次) ──→ AES-256 密钥 │
│ │
│ 私钥 PEM ──→ AES-256-GCM 加密 ──→ (salt + iv + tag + ciphertext) │
│ │
└─────────────────────────────────────────────────────────────┘
```
#### 密钥文件格式
```json
{
"version": 1,
"publicKey": "-----BEGIN PUBLIC KEY-----\n...",
"encryptedPrivateKey": "base64(salt + iv + tag + ciphertext)",
"createdAt": "2024-01-01T00:00:00.000Z"
}
```
### 3.2 存储位置
```
Windows: C:\Users\<用户名>\.captain-lobster\keys\<identity>.key
macOS: ~/.captain-lobster/keys/<identity>.key
Linux: ~/.captain-lobster/keys/<identity>.key
```
### 3.3 密钥生命周期
```
┌─────────────────────────────────────────────────────────────┐
│ 首次启动 │
│ │
│ 用户设置密码 ──→ 生成密钥对 ──→ 加密存储 ──→ 完成 │
│ ↓ │
│ 密钥文件已保存 │
└─────────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────────┐
│ 后续启动 │
│ │
│ 输入密码 ──→ 解密私钥 ──→ 加载到内存 ──→ 使用 │
│ ↓ │
│ 私钥在内存中短暂存在 │
└─────────────────────────────────────────────────────────────┘
```
## 4. 使用方法
### 4.1 首次启动
```javascript
// 用户需要提供密码
const result = await handler({
action: 'start',
password: '<你的密码>'
}, {})
// 返回
{
success: true,
data: {
captainName: '珍珠号·王发财',
publicKey: '-----BEGIN PUBLIC KEY-----...',
keyFile: '/home/user/.captain-lobster/keys/default.key'
}
}
```
### 4.2 后续启动
```javascript
// 只需输入密码解锁
const result = await handler({
action: 'initialize',
password: '<你的密码>'
}, {})
```
### 4.3 备份密钥
```javascript
// 导出加密备份
const backup docs/密钥设计-通俗版.md
# 🔐 龙虾船长密钥系统 - 通俗说明
## 什么是密钥？为什么需要它？
想象一下你是一名真正的船长，你需要一枚**印章**来证明你签署的文件是真实的。
在《龙虾船长》游戏中：
- **公钥** = 你的印章的公开部分，刻在名片上发给所有人
- **私钥** = 印章的**印模**，只有你自己知道，绝不能让别人看到
```
┌─────────────────────────────────────────────────────┐
│ 印章 vs 密钥 │
│ │
│ 真实印章 │
│ ├─ 公开面（给别人看）= 公钥 │
│ └─ 印模（只有你有） = 私钥 ⚠️ 绝密 │
└─────────────────────────────────────────────────────┘
```
### 为什么私钥这么重要？
如果你把私钥弄丢了或泄露了：
- ❌ 别人可以假冒你签字
- ❌ 偷走你的金币和货物
- ❌ 你的所有交易都会被伪造
---
## 我们的安全方案
### 问题 1：私钥放在哪里？
**方案**：像保护真钱一样保护私钥
```
真实世界：
💰 真金白银 → 放保险箱 → 用密码锁
数字世界：
🔑 私钥 → 加密存储 → 用密码保护
```
我们把私钥**加密**后存放在你的电脑里。就像：
- 你的微信支付密码保护你的钱
- 你的手机密码保护你的照片
### 问题 2：怎么加密？
我们使用**"密码 + 特殊数学公式"**来保护私钥：
```
第一步：你想一个密码（至少8位）
比如："船长发财123"
第二步：电脑用密码 + 数学公式 = 生成一把"钥匙"
这个过程叫 PBKDF2，很安全，要算10万次
第三步：用钥匙把私钥锁进保险箱
这个保险箱叫 AES-256，目前没人能破解
```
### 问题 3：加密后的私钥长什么样？
加密后的私钥是一堆乱码，看起来像这样：
```
J8kL2mN4pQ6rS8tU0vW2xY4zA6bC8dE0fG2h
```
即使黑客偷走了这个文件，他也需要：
1. 知道你的密码
2. 并且密码要足够复杂
---
## 实际操作流程
### 第一次玩（设置密码）
```
🎮 你：设置一个密码
🤖 系统：
1. 生成你的印章（公钥+私钥）
2. 用你的密码加密私钥
3. 保存到你的电脑
💾 保存位置：
Windows: C:\Users\你的用户名\.captain-lobster\keys\
Mac/Linux: ~/.captain-lobster/keys/
```
### 以后玩（解锁）
```
🎮 你：输入密码
🤖 系统：
1. 读取加密的私钥
2. 用密码解开保险箱
3. 取出私钥使用
```
### 备份私钥
```
🎮 你：导出备份
🤖 系统：
1. 读取私钥
2. 用新密码再次加密
3. 生成一串"乱码"发给你
📝 你：把这串乱码抄下来或保存到安全的地方
```
### 恢复私钥
```
📝 你：找到之前的备份
🎮 你：输入备份时的密码 + 设置新密码
🤖 系统：
1. 用备份密码解开备份
2. 用新密码重新加密
3. 保存到电脑
```
---
## 安全对比
### 不安全的方式 ❌
```
1. 私钥明文存在文件里
→ 任何人打开文件就能看到
2. 私钥存在 Skill 目录下
→ 换电脑/重装 Skill 私钥就没了
3. 私钥存在内存里
→ 电脑重启私钥就消失了
```
### 我们的方式 ✅
```
1. 私钥加密存储
→ 加密后的文件即使泄露也没用
2. 存在用户目录下
→ 重装 Skill 不影响密钥
3. 用密码保护
→ 别人拿到文件也需要密码
4. 文件权限 0o600
→ 只有你能读写这个文件
```
---
## 常见问题
### Q：我的密码忘了怎么办？
**A**：很遗憾，密码无法找回。
这就是"去中心化"的代价：
- 没有"忘记密码"按钮
- 没有客服帮你重置
- **你必须自己保管好密码**
建议：
- 写下密码放在安全的地方
- 使用密码管理器
### Q：备份的文件会被破解吗？
**A**：很难。
- 使用 AES-256 加密，这是银行级别的加密
- PBKDF2 迭代10万次，需要大量计算
- 目前没有已知的破解方法
但建议：
- 备份文件和密码分开保存
- 不要用简单密码
### Q：密钥文件会被黑客偷走吗？
**A**：有可能，但没关系。
- 密钥文件是加密的
- 黑客需要同时拿到：加密文件 + 你的密码
建议：
- 不要在公共电脑上玩
- 定期检查电脑安全
### Q：可以换手机/换电脑吗？
**A**：可以。
1. 导出备份（在旧电脑上）
2. 导入备份（在 新电脑上）
---
## 总结
### 安全等级
```
🔓 不安全：私钥明文存储
└─ 任何人都能看到
🔐 基础安全：私钥加密存储
└─ 需要密码才能使用
🔒 高级安全：加密 + 备份 + 权限控制
└─ 即使泄露也难以破解
```
### 我们做到了什么
| 安全措施 | 说明 |
|---------|------|
| ✅ 加密存储 | 私钥被 AES-256 加密 |
| ✅ 密码保护 | 需要密码才能解锁 |
| ✅ 独立存储 | 存在用户目录，与 Skill 分离 |
| ✅ 文件权限 | 只有你能读写 |
| ✅ 备份恢复 | 支持加密导出和导入 |
| ✅ 不保存明文 | 内存中也不长期保存私钥 |
---
## 一句话总结
> 我们把私钥当成你最重要的秘密——用密码锁在保险箱里，放到你自己的电脑上，备份时再次加密。
---
## 技术细节（可选阅读）
如果你对技术感兴趣：
### 加密算法
Github ReposUpdated 15h agoRank 70
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
MCPOPENCLAW
Github ReposUpdated 6mo agoRank 70
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
OPENCLAW
Github ReposUpdated 6mo agoRank 70
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
MCPOPENCLAW
Github ReposUpdated 7mo agoRank 70
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
OPENCLAW
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/ryanbihai/skills/captain-lobster",
"sourceUrl": "https://clawhub.ai/ryanbihai/skills/captain-lobster",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T05:47:11.904Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-ryanbihai-captain-lobster/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-ryanbihai-captain-lobster/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-10T05:47:11.904Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.6K downloads",
"href": "https://clawhub.ai/ryanbihai/captain-lobster",
"sourceUrl": "https://clawhub.ai/ryanbihai/captain-lobster",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T05:47:11.904Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.4.10",
"href": "https://clawhub.ai/ryanbihai/captain-lobster",
"sourceUrl": "https://clawhub.ai/ryanbihai/captain-lobster",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-05-14T13:12:35.478Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-ryanbihai-captain-lobster/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-ryanbihai-captain-lobster/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.4.10",
"description": "SDK API rename: register→createIdentity, getOpenId→getAddress, newOpenId→createAddress",
"href": "https://clawhub.ai/ryanbihai/captain-lobster",
"sourceUrl": "https://clawhub.ai/ryanbihai/captain-lobster",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-05-14T13:12:35.478Z",
"isPublic": true
}
]
}Record generated Oct 10, 2026.