Openclaw Ref — 技能 — openclaw中文资讯站

技能详情（站内镜像，无评论）

OpenClaw 配置、CLI、排错、模型管理完整参考手册。修改 openclaw.json、执行 CLI 命令、排查问题时必须查阅此 Skill。

数据与表格

作者：AstralWave @astralwaveorg

许可证：MIT-0

MIT-0 ·免费使用、修改和重新分发。无需归因。

版本：v1.0.0

统计：⭐ 0 · 222 · 2 current installs · 3 all-time installs

⭐ 0

安装量（当前） 3

🛡 VirusTotal ：良性 · OpenClaw ：良性

Package：astralwaveorg/openclaw-ref

安全扫描（ClawHub）

VirusTotal ：良性
OpenClaw ：良性

OpenClaw 评估

This is an instruction-only reference manual for OpenClaw; it contains docs and read-only guidance and does not request credentials, install code, or perform unexpected actions.

目的

Name/description match the contents: the skill is a documentation/reference manual and all referenced files, paths, and CLI commands are directly related to OpenClaw configuration, CLI, troubleshooting and model management. No unrelated binaries, env vars, or permissions are requested.

说明范围

SKILL.md tells the agent to locate and read the included documentation files and to consult config-fields.md before changing openclaw.json. It references only OpenClaw-related config paths (e.g. ~/.openclaw/...) and CLI commands. This is within the expected scope for a reference skill. Note: it does instruct use of a 'read' operation to fetch document contents — that is expected for a docs skill but means an agent/tool that runs this skill may…

安装机制

No install spec or code files are present; the skill is instruction-only so nothing is written to disk or downloaded during install.

证书

The skill declares no required environment variables, credentials, or config paths beyond referring to typical OpenClaw locations in documentation. There are no disproportionate or unrelated secret requests.

持久

always is false and the skill does not request any elevated/always-on privileges or attempt to modify other skills or global agent config. Autonomous invocation remains allowed by platform default (not a red flag here).

综合结论

This skill is a local reference manual and is internally consistent with its stated purpose. It does not ask for secrets or install code. Before enabling an agent to autonomously use it, consider: (1) the skill's runtime advice includes using a 'read' operation to open files under ~/.openclaw and workspace files — ensure those locations don't contain sensitive API keys or secrets you don't want the agent to read; (2) review the 'System prompts…

安装（复制给龙虾 AI）

将下方整段复制到龙虾中文库对话中，由龙虾按 SKILL.md 完成安装。

请把本段交给龙虾中文库（龙虾 AI）执行：为本机安装 OpenClaw 技能「Openclaw Ref」。简介：OpenClaw 配置、CLI、排错、模型管理完整参考手册。修改 openclaw.json、执行 CLI 命令、排查问题时必须查阅此 Skill。。
请 fetch 以下地址读取 SKILL.md 并按文档完成安装：https://raw.githubusercontent.com/openclaw/skills/refs/heads/main/skills/astralwaveorg/openclaw-ref/SKILL.md
（来源：yingzhi8.cn 技能库）

SKILL.md

打开原始 SKILL.md（GitHub raw）

---
name: openclaw-ref
description: OpenClaw 配置、CLI、排错、模型管理完整参考手册。修改 openclaw.json、执行 CLI 命令、排查问题时必须查阅此 Skill。
metadata:
  openclaw:
    emoji: "📖"
---

# OpenClaw 参考手册 (Skill)

> Astral 助手的 OpenClaw 操作手册。所有配置、排错、CLI 操作必须参考此文档。

## 使用方法
1. 先读本文件定位目标文档
2. 用 `read` 读取对应文件获取详细信息
3. 配置修改前必须查阅 `core/config-fields.md` 确认字段路径和类型

## 文件索引

### core/ — 核心参考 (最常用)
| 文件 | 内容 | 何时读取 |
|------|------|----------|
| `config-fields.md` | 扁平化字段速查表（路径→类型→默认值） | 修改 openclaw.json 时(最重要) |
| `config.md` | 完整配置示例+常见模式+遗漏字段补充 | 需要完整配置参考或示例时 |
| `cli.md` | 所有 CLI 命令速查表 | 需要执行 openclaw 命令时 |
| `models.md` | 模型管理、提供商配置、故障转移、扫描 | 添加/切换模型、配置提供商时 |
| `gateway.md` | 网关管理、网络、安全、认证、服务 | 网关配置、远程访问、多实例时 |
| `concepts.md` | 核心概念（会话、压缩、记忆、多Agent、系统提示） | 理解系统行为、调优时 |
| `nodes.md` | 节点管理（配对、Camera、Canvas、Screen、Exec） | 管理节点设备时 |

### channels/ — 渠道配置
| 文件 | 内容 | 何时读取 |
|------|------|----------|
| `overview.md` | 渠道通用配置、路由、配对、群组行为 | 配置任何渠道时先读 |
| `telegram.md` | Telegram 完整配置(Bot/群组/反应/流式) | 配置 Telegram 时 |
| `discord.md` | Discord 完整配置(服务器/频道/权限) | 配置 Discord 时 |
| `whatsapp-signal.md` | WhatsApp + Signal 配置 | 配置 WhatsApp/Signal 时 |
| `others.md` | Slack/BlueBubbles/iMessage/GoogleChat/飞书/Mattermost/LINE/Matrix等 | 配置其他渠道时 |

### automation/ — 自动化
| 文件 | 内容 | 何时读取 |
|------|------|----------|
| `cron.md` | 定时任务(创建/调度/投递/JSON模式) | 管理定时任务时 |
| `heartbeat.md` | 心跳系统(配置/提示/可见性) | 配置心跳时 |
| `hooks-webhooks.md` | Hooks + Webhooks + Gmail + 认证监控 + 投票 | 配置事件自动化时 |

### providers/ — 模型提供商
| 文件 | 内容 | 何时读取 |
|------|------|----------|
| `overview.md` | 所有提供商配置(内置+自定义+认证+常见示例) | 添加/配置任何提供商时 |

### tools/ — 工具系统
| 文件 | 内容 | 何时读取 |
|------|------|----------|
| `overview.md` | 工具策略、Exec、Browser、子Agent、Skills、插件 | 配置工具权限/行为时 |

### setup/ — 安装部署
| 文件 | 内容 | 何时读取 |
|------|------|----------|
| `install.md` | 安装、更新、Docker、迁移、卸载、环境变量、目录结构 | 安装/更新/迁移/环境问题时 |

### troubleshooting/ — 排错指南
| 文件 | 内容 | 何时读取 |
|------|------|----------|
| `general.md` | 通用排错(快速分类/常见问题/核选项) | 遇到问题时先读 |
| `channels-gateway-nodes.md` | 渠道+网关+节点问题排错表 | 特定组件问题时 |

### reference/ — 参考资料
| 文件 | 内容 | 何时读取 |
|------|------|----------|
| `api-security.md` | HTTP API(OpenAI+OpenResponses+Tools) + 安全 + 沙箱 | 配置API/安全/沙箱时 |
| `workspace-templates-webui.md` | 工作区文件映射 + 模板 + Web UI | 创建/修改工作区或配置WebUI时 |

## 关键原则
- **配置前必查**: 修改 `openclaw.json` 前必须查阅 `config-fields.md`
- **严格验证**: OpenClaw 拒绝未知字段，配置错误导致网关无法启动
- **备份优先**: 修改配置前备份 `~/.openclaw/openclaw.json`
- **用 doctor 修复**: 配置问题先跑 `openclaw doctor --fix`
- **环境变量**: API Key 用 `${VAR_NAME}` 引用，不硬编码
- **查日志**: `openclaw logs --follow` 是最佳信号源

## 源文档覆盖
本知识库覆盖了源仓库 docs/zh-CN/ 下所有14个目录(308个文件/55000+行)的核心内容:
cli, concepts, gateway, channels, automation, providers, tools, install, nodes, platforms, web, reference, help, security