Opphub

SKILL.md

---
name: opphub
description: 偶合 OppHub · 商业撮合 + 能力交换 · 公开 OPC · 5 通道独立推送 · 邮箱 / 手机号注册
version: 2.9.15
author: opphub-dev
license: MIT-0
homepage: https://api.opphub.ruiplus.cn
# skillhub.cn (中文社区) frontmatter —— 与 clawhub 字段并存、未识别字段忽略
# slug 与 clawhub 对齐用 'opphub' (clawhub 同名, skillhub 2026-07-07 拿到权限归 mtty123456)
# 老的 opphub-cn v1.0.5 已废弃, slug 重用为 'opphub'
slug: opphub
displayName: 偶合 OppHub
summary: 偶合 OppHub · 商业撮合 + 能力交换 · 公开 OPC · 5 通道独立推送
metadata:
  emoji: 🤝
  openclaw:
    skillKey: opphub
    requires:
      bins:
        - opphub
      env: []
      config: []
    primaryEnv: OPPHUB_AUTH
    envVars:
      - name: OPPHUB_AUTH
        required: false
        description: 偶合服务器登录 token。未提供时由 `opphub login` 交互写入 ~/.opphub/auth.json
      - name: OPPHUB_API_BASE
        required: false
        description: 偶合服务器 base URL；默认 https://api.opphub.ruiplus.cn
      - name: OPPHUB_NO_COOLDOWN
        required: false
        description: 设为 1 跳过验证码 cooldown（仅调试）
      - name: OPPHUB_RETRY
        required: false
        description: 自定义验证码自动重试次数
      - name: OPPHUB_STATE
        required: false
        description: 偶合 client 状态文件路径；默认 ~/.opphub/state.json
    os:
      - macos
      - linux
---

# 偶合 OppHub · 公开 OPC Skill

**面向 OPC（一人公司 / AI 创业者）的撮合 + 能力交换平台。**

本 skill 是偶合的官方客户端。装好后, 在 chat 里说“偶合注册 / 偶合状态 / 偶合商机” 即可使用。

## 是什么

- ✅ 做什么: 商业撮合 + 能力交换市场 + 5 通道独立推送
- ❌ 不做什么: 不做支付、不做信用分、不做链上账本、不做授权分级(未立项)

## 安装

**方式 1 · ClawHub 商店**
```bash
clawhub install opphub
```

### 安装后必读 (P0 修复提示)

> ⚠️ **普通用户必看 (v2.9.7 修复)**: 如果你装完运行 `opphub login` 报 `permission denied` 或 `No such file or directory`, 说明装包时丢了可执行位或个别 bin 文件. **跑一次下面这条修复**:
>
> ```bash
> # 1. 找装在哪
> SKILL_DIR=$(dirname $(which opphub 2>/dev/null) 2>/dev/null || ls -d ~/.openclaw/*/skills/opphub | head -1)
> # 2. 修权限 + 补缺文件 (从 GitHub 最新版同步)
> chmod +x "$SKILL_DIR"/bin/* 2>/dev/null
> curl -fsSL https://raw.githubusercontent.com/mtty123456/opphub/main/bin/opphub-login -o "$SKILL_DIR/bin/opphub-login" && chmod +x "$SKILL_DIR/bin/opphub-login"
> ```
>
> 这是 v2.9.5 → v2.9.6 → v2.9.7 期间 clawhub/skillhub 打 tar 时丢 +x / 漏文件遗留问题. v2.9.7 之后会内置 post-install 自动修.

**方式 2 · 一行 curl 装**
```bash
curl -fsSL https://api.opphub.ruiplus.cn/install/skill.sh | bash
```

## 第一次使用

1. 跑 `opphub status` 看账号状态
2. 未注册: 跑 `opphub register`, 用邮箱 / 手机号 + 验证码注册
3. 注册后: 跑 `opphub channel setup --auto` 绑至少 1 个 IM 通知通道
4. 完成了: 说“偶合商机 / 偶合匹配” 即可

## 命令一览

```bash
# 账号
opphub register           # 注册 + 引导
opphub login              # 登录
opphub logout             # 登出
opphub passwd             # 改密码
opphub status             # 看状态

# 通道
opphub channel list       # 已绑通道
opphub channel add        # 加通道
opphub channel remove     # 删通道

# 实时推送 (v2.9.13, 老板 17:14 拍推送全做)
opphub push enable        # 开启实时推送 (建 cron job, 55s 轮询)
opphub push disable       # 关闭实时推送
opphub push add           # 增加一个推送通道 binding
opphub push remove        # 删除一个推送通道 binding
opphub push list          # 看所有 binding + cron job 状态
opphub push status        # 看 cron job 跑情况

# 业务
opphub profile            # 个人 / 公司 / 能力 profile
opphub opportunities      # 需求池 / 商机
opphub suppliers          # 推荐供应商 / 能力方
opphub matches            # 撮合引擎 (需求 ↔ 能力)
opphub notify             # 推送历史 / 配置
```

## 5 通道独立 IM 通知

绑了哪个通道, 就推送到哪里。通道独立增删, 互不影响。

- feishu (飞书)
- dingtalk (钉钉)
- wecom (企业微信)
- sms (短信)
- email (邮箱)

## 错误码

| 错误码 | 处理 |
|---|---|
| `missing_agent_token` | 跑 `opphub status`, 引导重新注册 |
| `invalid_agent_token` / `expired_agent_token` | 同上 |
| `quota_exceeded` | 告诉用户今日配额用完 |
| `invalid_code` / `expired_code` | 重新走注册流程 |
| `rate_limited` | 提示等待再试 |

## 反馈

- ⭐ ClawHub star: https://clawhub.ai/mtty123456/skills/opphub
- 🐛 GitHub issue: https://github.com/mtty123456/opphub/issues

## 许可证

MIT-0. 任何人都可商用, 无需署名.