Agent skill

Guidance

by hyqibot in hyqibot/token-free-openclaw

回答用户关于 CoPaw 安装与配置的问题:优先定位并阅读本地文档,再提炼答案;若本地信息不足,兜底访问官网文档. An agent skill from hyqibot/token-free-openclaw.

Apache-2.0Auto-check passed

Install Guidance

skills CLI
$ npx skills add hyqibot/token-free-openclaw --skill guidance -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install hyqibot/token-free-openclaw guidance --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/hyqibot/token-free-openclaw.git skills-src && mkdir -p .claude/skills && cp -r skills-src/copaw/agents/skills/guidance .claude/skills/guidance && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
guidance
GitHub stars
129
Token cost
~615 tokens
SKILL.md length
66 words
Files
1
Skills in repo
2
Repo updated
First seen
Licence
Apache-2.0

At a glance

回答用户关于 CoPaw 安装与配置的问题:优先定位并阅读本地文档,再提炼答案;若本地信息不足,兜底访问官网文档. An agent skill from hyqibot/token-free-openclaw.

  • SKILL.md covers 标准流程 and 输出质量要求
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Guidance is an agent skill from hyqibot/token-free-openclaw. 回答用户关于 CoPaw 安装与配置的问题:优先定位并阅读本地文档,再提炼答案;若本地信息不足,兜底访问官网文档。

Its SKILL.md is about 620 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: 永久免 token 费的 openclaw, ChatGPT、Claude、Gemini、DeepSeek、千问、豆包、Kimi、智谱清言均可免费;三个重磅 Skill 大幅提升桌面执行能力;无需安装,开箱即用;支持微信、钉钉等多端接入控制。兼容所有 OpenClaw 技能,并提供更强的 Skill…. The licence is Apache-2.0.

Example prompts

  • “/guidance”

What it can do on your machine

Read from SKILL.md and the folder at commit cc8e43f. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash and markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • copaw.agentscope.io

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Guidance loads about 615 tokens when it runs. Until then it costs about 17 tokens; SKILL.md has 66 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~17
When it runs · the whole SKILL.md, loaded when a task matches
~615

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from hyqibot/token-free-openclaw at commit cc8e43f, republished under its Apache-2.0 licence (© hyqibot). 66 words, ~615 tokens.

Download SKILL.mdSave it as .claude/skills/guidance/SKILL.md (or your agent's skills folder).
name
guidance
description
回答用户关于 CoPaw 安装与配置的问题:优先定位并阅读本地文档,再提炼答案;若本地信息不足,兜底访问官网文档。
metadata.builtin_skill_version
1.1

CoPaw 安装与配置问答指南

当用户询问 CoPaw 的安装、初始化、环境配置、依赖要求、常见配置项 时,使用本 skill。

核心原则:

  • 先查本地文档,再回答
  • 回答要基于已读到的内容,不臆测
  • 回答语言与用户提问语言保持一致

标准流程

第一步:定位文档位置

查找记忆中的文档目录

首先你可以查看memory中是否有文档目录,如果有则直接使用,如果没有则继续执行下一步。

bash
# 获取memory中的文档目录
DOC_DIR=$(find ~/.copaw/memory/ -type d -name "docs")

如果 memory 中没有文档目录,则继续执行下面的逻辑。

检查项目源码中的文档目录

执行以下脚本逻辑来获取变量 $COPAW_ROOT:

bash
# 获取二进制绝对路径
COP_PATH=$(which copaw 2>/dev/null || whereis copaw | awk '{print $2}')

# 逻辑推导:如果路径包含 .copaw/bin/copaw,则根目录在其上三层
# 例如:/path/to/CoPaw/.copaw/bin/copaw -> /path/to/CoPaw
if [[ "$COP_PATH" == *".copaw/bin/copaw" ]]; then
    COPAW_ROOT=$(echo "$COP_PATH" | sed 's/\/\.copaw\/bin\/copaw//')
else
    # 兜底:尝试获取所在目录的父目录
    COPAW_ROOT=$(dirname $(dirname "$COP_PATH") 2>/dev/null || echo ".")
fi

echo "Detected CoPaw Root: $COPAW_ROOT"

验证并列出文档目录: 使用推导出的 $COPAW_ROOT 定位文档:

bash
# 组合标准文档路径
="$COPAW_ROOT/website/public/docs/"

# 检查路径是否存在并列出文件
if [ -d "$DOC_DIR" ]; then
    find "$DOC_DIR" -type f -name "*.md" | head -n 100
else
    # 如果推导路径不对,执行全局模糊搜索
    find "$COPAW_ROOT" -type d -name "docs" | grep "website/public/docs"
fi

如果项目文档不存在,搜索工作目录

如果还是找不到文档,搜索 copaw 安装路径下的可用文档内容:

bash
# 寻找 faq.en.md 或 config.zh.md 等特征文件
FILE_PATH=$(find . -type f -name "faq.en.md" -o -name "config.zh.md" | head -n 1)
if [ -n "$FILE_PATH" ]; then
    # 使用 dirname 获取该文件所在的目录
    DOC_DIR=$(dirname "$FILE_PATH")
fi

如果找到了文档目录,请你记录在 memory 中,格式为:

markdown
# 文档目录
$DOC_DIR = <doc_path>
第二步:文档检索与匹配

文档文件命名格式为 <topic>.<lang>.md(如 config.zh.md、config.en.md、quickstart.zh.md)。

使用 find 命令在目标目录中列出所有符合后缀的文档,并根据文件名关键字(如 install, env, setup)锁定目标作为 <doc_path>。

bash
# 列出所有符合后缀的文档
find $DOC_DIR -type f -name "*.md"

如果没有合适的文档,则在下一步阅读所有文档内容。

第三步:阅读文档内容

找到候选文档后,读取并确认与问题相关的段落。可使用:

  • cat <doc_path>
  • file_reader skill(推荐用于更长文档或分段读取)

如果文档很长,优先读取和问题最相关的章节(安装步骤、配置项、示例命令、注意事项、版本要求)。

第四步:提取信息并作答

从文档中提取关键信息,组织成可执行答案:

  • 先给直接结论
  • 再给步骤/命令/配置示例
  • 补充必要前置条件与常见坑

语言要求:回答语言必须与用户提问语言一致(中文问就中文答,英文问就英文答)。

第五步(可选):官网检索

若前面步骤无法完成(本地无文档、文档缺失、信息不足),使用官网作为兜底:

基于官网可获得内容继续回答,并在答案中明确说明该结论来自官网文档。

输出质量要求

  • 不编造不存在的配置项或命令
  • 遇到版本差异时,明确标注“需以当前文档版本为准”
  • 涉及路径、命令、配置键时,尽量给可复制的原文片段
  • 若信息仍不足,明确缺口并告诉用户还需要哪类信息(例如操作系统、安装方式、报错日志)

© hyqibot, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in copaw/agents/skills/guidance of hyqibot/token-free-openclaw.

Open the folder on GitHubat commit cc8e43f

Compare with similar skills

Guidance next to the 2 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Guidance compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Guidance this skillhyqibot/token-free-openclaw129—~615Automated safety check: PassApache-2.0
Copaw Opschujianyun/skills742—~1.3kAutomated safety check: PassCustom licence
Guidancemateaix/mateclaw1.2k—~260Automated safety check: PassApache-2.0

Similar skills

  • Copaw Ops

    chujianyun/skills

    CoPaw 运维助手。用于用户提到 copaw 运维、服务无响应、渠道断连、MCP 失败、模型调用失败、cron 不执行、Docker 部署、重载、重启或重置恢复时使用。优先执行状态检查与故障分流;涉及重启、重载、重置、配置修改等高影响动作时,先向用户说明再执行。

    742 GitHub stars~1.3k tokensUpdated yesterday
    DevOps & CloudAuto-check passed
  • Guidance

    mateaix/mateclaw

    回答用户关于 MateClaw 安装与配置的问题。优先定位并阅读本地文档,再提炼答案;文档不足时访问官网. An agent skill from mateaix/mateclaw.

    1.2k GitHub stars~260 tokensUpdated 2 days ago
    Auto-check passed

More from hyqibot/token-free-openclaw

  • Cron

    hyqibot/token-free-openclaw

    Use this skill only for scheduled or recurring tasks. An agent skill from hyqibot/token-free-openclaw.

    129 GitHub stars~830 tokensUpdated 1 mo ago
    Auto-check passed

Questions about Guidance

What does Guidance do?

回答用户关于 CoPaw 安装与配置的问题:优先定位并阅读本地文档,再提炼答案;若本地信息不足,兜底访问官网文档. An agent skill from hyqibot/token-free-openclaw. Guidance is an agent skill from hyqibot/token-free-openclaw.

How do I install Guidance in Claude Code?

Run `npx skills add hyqibot/token-free-openclaw --skill guidance -a claude-code`. Or copy the skill folder (copaw/agents/skills/guidance in hyqibot/token-free-openclaw) into .claude/skills/guidance in your project. Claude Code loads it when a task matches its description.

How do I install Guidance in Codex?

Run `npx skills add hyqibot/token-free-openclaw --skill guidance -a codex`. Or copy the skill folder (copaw/agents/skills/guidance in hyqibot/token-free-openclaw) into .agents/skills/guidance in your project. Codex loads it when a task matches its description.

Can I use Guidance in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add hyqibot/token-free-openclaw --skill guidance -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/guidance, .gemini/skills/guidance, .github/skills/guidance and .opencode/skills/guidance in your project.

What does Guidance need to run?

SKILL.md names no scripts, command-line tools or credentials: Guidance is instructions for the agent only.

Does Guidance access the network?

SKILL.md names 1 domain. As links in the text: copaw.agentscope.io. This is read from the text; nothing was executed.

Is Guidance safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Guidance use?

Guidance is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Guidance use?

About 615 tokens (SKILL.md is roughly 2.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Guidance?

Skills that share tags, products or a category with Guidance: Copaw Ops (chujianyun/skills, 742 stars) and Guidance (mateaix/mateclaw, 1.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Guidance?

hyqibot (a GitHub user) maintains it in hyqibot/token-free-openclaw, which has 129 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on August 23, 2026.

Source: hyqibot/token-free-openclaw on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.