# cpolar-guide-skill

**Repository Path**: jun-wan/cpolar-guide-skill

## Basic Information

- **Project Name**: cpolar-guide-skill
- **Description**: 一个给 OpenClaw 使用的 cpolar-guide skill。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-19
- **Last Updated**: 2026-04-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# cpolar-guide-skill

一个给 OpenClaw 使用的 `cpolar-guide` skill。

## 这个 skill 是干什么的

这是一个同时面向两类场景的 skill：

- **support**：回答 cpolar 安装、使用、套餐、排障、平台差异等问题
- **execution reference**：给 OpenClaw 在当前操作系统上直接代执行安装、穿透、部署、抓取公网地址时参考

它不是 cpolar 客户端本体，也不是独立程序，而是给 OpenClaw / agent 读取的专项 skill。

## 适用问题

例如：

- Windows / macOS / Ubuntu / Termux / OpenWrt / 群晖怎么安装 cpolar
- 9200 是什么，为什么打不开
- 怎么创建 HTTP / TCP / FTP 隧道
- 地址为什么会变，怎么固定
- 连接数/分钟是什么意思
- 用户不一致 / 登录超限怎么处理
- Termux PRoot Ubuntu 怎么安装 cpolar
- 让 OpenClaw 直接帮你在当前机器上安装、穿透、抓 stdout、提取公网地址

## 仓库结构

```text
cpolar-guide/
├── SKILL.md
└── references/
    ├── install.md
    ├── commands.md
    ├── advanced-usage.md
    ├── platforms.md
    ├── troubleshooting.md
    ├── plan-tiers.md
    ├── faq-templates.md
    ├── uninstall.md
    ├── official-links.md
    └── openclaw-ops.md
```

## 安装方式

> 说明：OpenClaw 当前通常不是通过 `openclaw skills install <url>` 这种一条命令直接安装远程 skill。
> 所以这里说的“在线安装”，通常指的是：**直接从 Git 仓库在线拉取，然后放到目标主机的 skills 目录中使用。**

### 方式一：在线安装（推荐）

适合：目标机器能联网，且可直接访问 Gitee。

#### 1. 克隆仓库

```bash
git clone https://gitee.com/jun-wan/cpolar-guide-skill.git
```

克隆完成后，你会得到这个目录：

```text
cpolar-guide-skill/
```

里面真正的 skill 目录是：

```text
cpolar-guide-skill/cpolar-guide/
```

#### 2. 找到目标 OpenClaw 主机的 skills 目录

常见做法是把 `cpolar-guide/` 放进该主机可被 OpenClaw 读取的 skills 目录中。

如果你自己有自定义 skills 目录，就把它放进去。  
如果你当前主机是默认 workspace 结构，也可以放到类似这样的目录：

```text
~/.openclaw/workspace/skills/
```

最终目录结构应当像这样：

```text
~/.openclaw/workspace/skills/cpolar-guide/
  SKILL.md
  references/
```

#### 3. 复制 skill 目录

例如：

```bash
cp -R cpolar-guide-skill/cpolar-guide ~/.openclaw/workspace/skills/
```

如果目标目录已经有旧版，可以先备份，再覆盖。

#### 4. 检查 OpenClaw 是否识别到 skill

可以尝试：

```bash
openclaw skills list
openclaw skills check
```

如果 skill 已被识别，你应该能在技能列表或检查结果里看到 `cpolar-guide`。

---

### 方式二：在线更新

如果你已经在某台机器上通过 Git 方式放好了这个 skill，后续更新就可以直接 pull：

```bash
cd cpolar-guide-skill
git pull
```

然后把更新后的 `cpolar-guide/` 再同步到目标 skills 目录。

如果你一开始就是把整个仓库直接放在技能目录旁边维护，也可以按你自己的目录结构直接同步。

---

### 方式三：离线安装 / 手动分发

如果目标主机不方便直接访问 Gitee，也可以走离线方式：

1. 在一台能联网的机器上下载本仓库
2. 拷贝其中的 `cpolar-guide/` 目录
3. 放到目标 OpenClaw 主机的 skills 目录中

或者使用已打包的 `.skill` 文件进行分发。

## 推荐目录摆放方式

### 方案 A：仓库和实际 skill 分开

```text
~/projects/cpolar-guide-skill/
~/.openclaw/workspace/skills/cpolar-guide/
```

优点：

- 仓库干净
- OpenClaw 工作目录清晰
- 更新和同步容易理解

### 方案 B：直接把 skill 仓库内容用于同步源

先 clone 仓库，再把其中的 `cpolar-guide/` 作为实际 skill 目录同步过去。

无论哪种方式，**OpenClaw 真正要读取的是 `cpolar-guide/` 目录，不是仓库根目录本身。**

## OpenClaw 如何使用这个 skill

当用户提到以下意图时，OpenClaw 可以命中这个 skill：

- cpolar 安装
- 内网穿透
- 映射本地端口到公网
- Webhook 调试
- 远程 SSH
- 9200 / Web UI
- 固定地址 / 套餐差异
- Termux / OpenWrt / 群晖 / 树莓派 等平台问题

命中后，OpenClaw 会读取：

- `SKILL.md`
- 以及按需读取 `references/*.md`

## 这个 skill 的特点

### 1. 对官网口径对齐

回答时优先参考：

- `https://www.cpolar.com/download`
- `https://www.cpolar.com/docs/`
- 官方平台教程文章

### 2. 对用户输出时优先贴真实链接

不会只说“见某个内部文件”，而是要求对用户直接展开真实 URL。

### 3. 同时覆盖 support + execution reference

既能：

- 回答用户问题

也能：

- 给 OpenClaw 提供直接代操作的执行参考

例如：

- 临时 CLI 隧道要抓 stdout
- 要从 `Forwarding` / `PublicUrl` 提取公网地址
- 前台临时隧道和持久后台部署不能混为一谈

## 常见问题

### Q1：为什么不是一个命令直接从 URL 安装？

因为 OpenClaw 当前常见用法里，skills 命令主要是：

- `openclaw skills list`
- `openclaw skills info`
- `openclaw skills check`

并不一定内置“远程 URL 一键安装”这个子命令。  
所以目前最稳妥的“在线安装”，就是：

- `git clone` 在线拉仓库
- 把 `cpolar-guide/` 放进目标 skills 目录

### Q2：仓库根目录和 skill 目录是什么关系？

仓库根目录是：

```text
cpolar-guide-skill/
```

真正给 OpenClaw 读取的 skill 目录是：

```text
cpolar-guide-skill/cpolar-guide/
```

### Q3：怎么确认安装成功？

可以检查：

```bash
openclaw skills list
openclaw skills check
```

并确认目标目录里存在：

```text
cpolar-guide/SKILL.md
```

## 仓库地址

- Gitee：https://gitee.com/jun-wan/cpolar-guide-skill