clawpilot

OpenClaw 专家技能

自动更新检查（先运行）

在执行任何其他操作之前，运行过时检查：

bash scripts/check_updates.sh

• 如果是 UP_TO_DATE：正常继续。
• 如果是 STALE：技能参考资料可能已过时。在继续处理用户任务之前：
  1. 获取 https://github.com/openclaw/openclaw/releases 上最新的 3–5 个版本
  2. 获取 https://docs.openclaw.ai/llms.txt，检查文档变更
  3. 搜索网络，查看近期的 OpenClaw CVE 或安全公告
  4. 对照 SKILL.md frontmatter 和 references/security.md 中的版本
  5. 告知用户发现的版本差距或新的安全问题
  6. 如果参考资料已更新，运行：bash scripts/mark_updated.sh <latest-version>
  7. 如果无需更新，也要标记为已检查：bash scripts/mark_updated.sh <current-version>

此检查使用 .last_update_check 标记文件。阈值为 7 天（可通过第一个参数配置）。

安全优先原则

每项配置操作在建议之前都必须经过安全审查。

对于每项设置变更，请评估：

1. 影响范围——如果此设置遭到利用，攻击者可以访问哪些内容？
2. 凭据暴露——机密是否安全存储？权限是否正确？
3. 网络暴露面——网关暴露范围是否超出必要程度？
4. 提示词注入风险——不可信消息内容是否可能操纵 Agent？
5. 供应链风险——已安装的技能/插件是否来自可信来源？

建议配置时，务必先给出安全基线，再说明放宽限制的权衡。

关键 CVE（必须检查）

• CVE-2026-25253（CVSS 8.8）：通过 Control UI 窃取令牌——已在 2026.1.29 中修复
• CVE-2026-24763：命令注入——已在 2026.1.29 中修复
• CVE-2026-25157：命令注入（可与 25253 串联利用）——已在 2026.1.29 中修复
• 2026.2.12：大规模安全补丁（40+ 个漏洞）——路径遍历、SSRF、权限提升
• 2026.2.15+：SHA-256 沙箱哈希、加固插件发现机制、修复 ACP 会话 DoS 问题
• 2026.2.17+：SSRF ISATAP 防护、iMessage SSH 主机密钥强制校验、控制平面 RPC 速率限制
• 2026.2.19：加固浏览器中继身份验证（/extension 和 /cdp 需要 gateway-token）

在提供任何其他建议之前，务必确认用户的版本不低于 2026.2.19。

快速参考

任务	命令
安装	npm install -g openclaw@latest
引导配置	openclaw onboard --install-daemon
启动网关	openclaw gateway --port 18789
登录渠道	openclaw channels login
健康检查	openclaw health
安全审计	openclaw security audit --deep
技能安全扫描	openclaw skills scan <path>
诊断	openclaw doctor
更新	openclaw update
查看日志	openclaw logs
状态（已脱敏）	openclaw status --all
Agent 管理	openclaw agents list
iOS/macOS 节点	openclaw nodes
设备管理	openclaw devices remove/clear
Cron（错峰）	openclaw cron add --stagger/--exact
启动子 Agent	/subagents spawn
Shell 补全	openclaw completion

运行 openclaw --help 查看完整命令列表。

文档来源

优先使用此技能随附的参考文件。这些文件涵盖核心配置架构、安全加固（包括 CVE、OWASP 映射、NIST 对齐）、云部署和多 Agent 路由。

仅在以下情况下从 https://docs.openclaw.ai/ 获取内容：

• 随附的参考资料未涵盖用户询问的功能
• 特定版本的行为需要查阅最新文档
• 随附的参考资料中没有相关命令或配置键

完整文档索引：https://docs.openclaw.ai/llms.txt

核心架构

Chat Apps --> Gateway (single process) --> AI Agent(s)
             |                              |
             +- Session manager             +- Workspace (SOUL.md, AGENTS.md, MEMORY.md)
             +- Channel routing             +- Auth profiles
             +- Tool policies               +- Memory (daily logs + vector search)
             +- Sandbox (Docker)            +- Sessions
             +- Cron scheduler              +- Skills
             +- Safety scanner              +- Subagents
             +- Agent mgmt RPC             +- iOS/macOS nodes

• 网关：会话、路由和频道连接的唯一事实来源。默认绑定到 127.0.0.1:18789。
• Agent：彼此隔离的实体，各自拥有工作区、状态目录、身份验证配置和会话存储。可通过 RPC（agents.create、agents.update、agents.delete）管理。
• 频道：基于插件构建，支持 WhatsApp、Telegram、Discord、Slack、iMessage、Signal、LINE、Matrix、Teams、Google Chat、Mattermost、BlueBubbles、Feishu、Zalo。
• 配置：~/.openclaw/openclaw.json（JSON5 格式）。OPENCLAW_HOME 环境变量可覆盖主目录，用于解析路径。
• 节点：iOS alpha + macOS 节点，可通过配对远程执行代码。
• iOS：Watch Companion（收件箱 UI、通知中继）、Share Extension（将内容转发到网关）、APNs 推送通知（v2026.2.19+）。

安全基线

始终从安全基线开始，仅在有充分理由时放宽限制。关键默认值：bind: "loopback"、dmPolicy: "pairing"、sandbox: { mode: "non-main" }、redactSensitive: "tools"。

重大变更（v2026.2.10–2026.2.19）

• WebChat 客户端无法使用网关 HTTP API（sessions.patch、sessions.delete）
• 浏览器中继现在要求 /extension 和 /cdp 端点均通过网关令牌进行身份验证
• 子 Agent 任务消息现在会以来源上下文作为前缀
• 周期性整点计划现在默认应用 Cron 错峰设置

完整基线模板和记忆系统配置：参见配置参考和安全强化。

常见工作流

初始设置

1. npm install -g openclaw@latest
2. openclaw onboard --install-daemon
3. openclaw channels login（选择频道）
4. openclaw gateway --port 18789
5. 运行 openclaw security audit --deep ——修复所有发现的问题
6. 运行 openclaw skills scan ——验证已安装的技能是否安全
7. 验证：运行 openclaw health 并打开 http://127.0.0.1:18789/

添加频道

1. openclaw channels login -> 选择频道
2. 在 openclaw.json 中配置允许列表（生产环境中切勿使用 "*"）
3. 设置 dmPolicy: "pairing" 或 "allowlist"
4. 对于群组：设置 requireMention: true
5. 安全审查：验证允许列表，并检查该频道的工具访问权限

远程访问（安全）

首选：Tailscale Serve ——保留 loopback 绑定，不向公网暴露。 替代方案：SSH 隧道 —— ssh -N -L 18789:127.0.0.1:18789 user@host 切勿：在没有身份验证令牌和防火墙的情况下绑定到 0.0.0.0。

故障排除

1. openclaw doctor ——验证配置
2. openclaw health ——查看网关状态
3. openclaw logs ——查看近期日志
4. openclaw status --all ——查看完整状态（机密信息已隐藏）
5. openclaw memory search "topic" ——搜索 Agent 记忆
6. openclaw sessions list ——查看活跃会话
7. 检查 /tmp/openclaw/openclaw-YYYY-MM-DD.log

查找和安装技能

当用户询问如何通过新技能扩展 OpenClaw，或询问“有哪些可用技能”时：

1. 官方注册表：https://clawhub.com
2. 社区精选列表（1,715+ 个技能，31 个类别）：https://github.com/VoltAgent/awesome-openclaw-skills
3. 通过 CLI 安装：npx clawhub@latest install <skill-slug>
4. 手动安装：将技能文件夹复制到 ~/.openclaw/skills/（全局）或 <project>/skills/（工作区）

安全：第三方技能会以受信任代码的身份运行。**2026 年初，ClawHub 上发现了数百个恶意技能。**务必：

• 在安装前运行 openclaw skills scan <skill-path>（v2026.2.6+）
• 审查源代码，尤其是使用 exec、browser 或 web_fetch 工具的技能
• 固定版本，避免自动更新不受信任的技能

技能配置架构（加载顺序、每个技能的 env/apiKey、热重载）：参见配置参考。技能生态系统 URL（ClawHub 注册表、社区列表）：参见安全强化——技能供应链。

本地检查脚本

有原生 CLI 时优先使用：openclaw security audit --deep、openclaw doctor、openclaw config get 可提供权威结果。仅在需要进行更深入的启发式检查或 CLI 不可用时，才使用以下脚本。

针对本地 OpenClaw 安装运行这些脚本。所有脚本都接受 --state-dir PATH，用于指定替代 ~/.openclaw 的目录。脚本使用基于 grep 的启发式解析来处理 JSON5 配置，结果仅供参考。

完整安全审计

bash scripts/security_audit.sh [--state-dir ~/.openclaw]

检查：版本/CVE 状态、文件权限、硬编码凭据、网络绑定、DM 策略、沙箱配置、工具策略、日志脱敏、插件、技能供应链（数据外泄/反向 Shell/混淆模式）、Control UI 安全性（CVE-2026-25253）、反向代理配置（CVE-2026-24763）、网关进程暴露情况、同步文件夹检测、会话密钥扫描。映射至 OWASP Agentic Top 10 和 NIST CSF。返回 CRITICAL/WARNING/PASS 摘要。

配置检查器

bash scripts/config_inspector.sh [--section gateway|channels|agents|tools|sessions|logging|all]

解析 openclaw.json，并按章节报告与安全相关的设置，同时提供彩色建议。

提示词与系统指令检查器

bash scripts/prompt_checker.sh [--workspace PATH]

扫描 AGENTS.md、SOUL.md、USER.md、CLAUDE.md 和其他启动文件，检查是否存在：缺少安全防护措施、权限过于宽松的指令、硬编码密钥、基础设施暴露、提示词注入漏洞，以及缺少身份边界。

会话记录扫描器

bash scripts/session_scanner.sh [--agent AGENT_ID] [--max-files 20] [--deep]

扫描 .jsonl 会话文件，查找泄露的凭据（AWS 密钥、GitHub PAT、API 密钥、私钥、机器人令牌、Google API 密钥）。使用 --deep 时，还会检查 IP 地址、Base64 数据块、文件路径和旧文件。

输出示例

security_audit.sh（节选）：

============================================
  1. Version & Known Vulnerabilities
============================================
[PASS]     Version 2026.2.19 includes CVE-2026-25253/24763/25157 patches
[PASS]     Version includes skill/plugin safety scanner (v2026.2.6+)
...
============================================
  Audit Summary
============================================
  0 CRITICAL
  2 Warnings
  3 Informational
  8 Passed

config_inspector.sh（节选）：

=== Gateway Configuration ===
  Mode:      local (default)
  Bind:      loopback (default)
  Port:      18789 (default)
  ✓ Loopback bind (secure default)

session_scanner.sh（节选）：

Found 5 session file(s) to scan (max: 20)
--- agents/main/sessions/2026-02-10.jsonl (1.2M) ---
[CRITICAL]   AWS Access Key: 1 match(es)
=== Summary ===
  1 file(s) contain potential secrets (1 total matches)

脚本前置条件与错误处理

所有脚本都需要 bash 和标准 Unix 工具（grep、awk、wc、stat）。如果脚本运行失败：

• 未找到 ~/.openclaw：传入 --state-dir PATH 指向实际的 OpenClaw 主目录，或设置 OPENCLAW_HOME。
• 未安装 jq：config_inspector.sh 使用基于 grep 的启发式解析，不需要 jq。其他脚本也不依赖 jq。
• 权限被拒绝：脚本只读取文件，请确保当前用户拥有对 ~/.openclaw/ 的读取权限。不要以 root 身份运行。
• 未找到会话文件：session_scanner.sh 会在 agents/*/sessions/*.jsonl 中查找。如果会话存储在其他位置，请传入 --state-dir。
• openclaw.json 为空或缺失：脚本会针对缺失的键报告警告，但不会崩溃。缺失的配置文件会被视为“全部采用默认值”。

何时运行脚本

用户请求	脚本
“检查我的 OpenClaw 安全性”	security_audit.sh
“我的配置安全吗？”	config_inspector.sh
“审查我的 Agent 提示词”	prompt_checker.sh
“是否有泄露的密钥？”	session_scanner.sh --deep
“全面安全审查”	按顺序运行全部四个脚本
“检查是否存在恶意技能”	security_audit.sh（第 9 节）+ openclaw skills scan

参考文件

根据用户的任务，按需阅读以下文件：

• 安全强化 — 已知的 CVE、OWASP Agentic Top 10 映射、NIST CSF 对齐、技能供应链安全、允许列表、沙箱、工具策略、凭据管理、审计清单、事件响应、提示词注入防御。对于任何与安全相关的问题，或在建议更改配置之前，都必须阅读此文件。

  • 快速查找：grep -n "CVE\|sandbox\|dmPolicy\|tool.polic\|prompt.inject\|incident" references/security.md

• 配置参考 — 所有配置键、环境变量、渠道设置（WhatsApp/Telegram/Discord/Slack/iMessage/Signal/BlueBubbles 等）、会话管理、模型提供商、工具、日志记录、OPENCLAW_HOME。

  • 快速查找：grep -n "whatsapp\|telegram\|discord\|slack\|imessage\|signal\|bind\|sandbox\|dmPolic\|session" references/configuration.md

• 云部署 — Docker、GCP、AWS Bedrock、Fly.io、Railway、Render、Hetzner、Northflank、Nix、Ansible、macOS VM。网络架构、IAM、卷、通过 Tailscale/SSH 进行远程访问。

• 多 Agent 与路由 — Agent 隔离、路由规则、按 Agent 设置沙箱/工具、绑定、会话范围、子 Agent、心跳、Agent 间通信。