tool-openclaw

OpenClaw 专家

目标：使用 references/docs/ 下打包的文档快照，回答 OpenClaw 安装、配置和运维问题。

默认假设：快照是事实依据。不要猜测命令标志或配置键。

输入 / 输出约定（必需）

读取（主要内容）：

• references/docs/**（https://docs.openclaw.ai/*.md 的离线镜像）
• references/entrypoints.md（整理后的索引）
• references/model-migration-audit.md（用于提供商 / 模型迁移的简短和完整审计提示词及报告格式）
• references/troubleshooting.md（路由 / 操作手册）

写入：

• 默认不写入任何内容。
• 如果刷新快照：references/docs/** + references/docs/__SNAPSHOT_INDEX.md + references/docs/llms.txt

流程（必需）

1. 将问题归入以下一个领域：

• 安装 / 入门
• 网关
• 频道（whatsapp/telegram/discord/mattermost/imessage）
• 节点 / Web 界面
• 远程访问（ssh/tailscale）
• 身份验证 / oauth
• 模型迁移 / 提供商切换
• 沙箱 / 工具策略

2. 回答前搜索快照。

• 优先搜索用户提供的完整错误字符串。
• 如果没有错误字符串，则搜索具体的命令 / 配置键。
• 打开 1–2 个相关页面，并提取准确的命令 / 配置字段。

3. 使用下方模板作答，并注明查阅过的文档。

4. 如果用户询问模型 / 提供商迁移：

• 在建议更改前检查本地环境
• 确认当前模型路径、身份验证模式，以及有意义的 Agent / 运行时通道
• 区分公开角色与底层运行时及服务账号
• 从通道问题评估迁移，而不只是关注模型 ID
• 使用 references/model-migration-audit.md 中的简短提示词、完整提示词和报告格式
• 面向运维人员的提示词应简短；由此技能承载工作流

安全注意事项（必需）

• 切勿索要或复述机密（令牌、API 密钥）。如果用户分享了配置 / 日志，请让他们先删去机密信息。
• 明确说明具有破坏性的步骤（重置会话 / 状态、删除配置文件），并要求确认。
• 除非文档明确说明可以这样做且你解释了权衡，否则不要建议降低安全默认设置（身份验证、沙箱）。

搜索工作流（建议）

先使用类似 grep 的方式搜索；不要通读整个快照。

示例（在 Markdown 文件中进行正则搜索）：

• 按错误文本搜索：

  • 模式：完整错误行（必要时转义正则表达式元字符）
  • 路径：references/docs
  • 包含：*.md

• 按配置键搜索：

  • canvasHost
  • allowFrom
  • requireMention
  • session.mainKey

• 按命令搜索：

  • openclaw onboard
  • openclaw gateway
  • openclaw channels login
  • openclaw doctor
  • 旧版：clawdbot ... 可能作为兼容性垫片存在（参见文档）。

如果需要页面索引，请从以下文件开始：

• references/docs/__SNAPSHOT_INDEX.md

如果快照似乎已过期或缺少页面，请刷新（参见 references/docs_snapshot.md）。

关键入口（快照）

• references/docs/start/getting-started.md
• references/docs/start/wizard.md
• references/docs/start/wizard-cli-reference.md
• references/docs/gateway/configuration.md
• references/docs/gateway/authentication.md
• references/docs/gateway/cli-backends.md
• references/docs/providers/anthropic.md
• references/docs/providers/openai.md
• references/docs/providers/minimax.md
• references/docs/providers/zai.md
• references/docs/concepts/oauth.md
• references/docs/concepts/agent-workspace.md
• references/docs/gateway/troubleshooting.md
• references/docs/help/troubleshooting.md

输出格式（必需）

请使用以下结构作答：

Diagnosis: <1 sentence>

Docs consulted:
- <path 1>
- <path 2>

Steps:
1) <actionable step>
2) <actionable step>

Verify:
- <how to confirm it worked>

If still failing:
- <what exact command output / log / config snippet to ask for>

更新文档快照

随附的文档快照位于 references/docs/ 下，索引文件为：

• references/docs/__SNAPSHOT_INDEX.md（面向人工和 Agent 的路由）
• references/docs/__SNAPSHOT_INDEX.json（机器索引）

要更新或重建快照索引：

cd tool-openclaw
# If you are working inside this repo instead of an installed skill:
# cd skills/tool-openclaw
./scripts/update.sh --mode index

最常用的模式：

• --mode seed：刷新占位文件、旧版或无标题页面，以及过期页面（默认过期阈值：14 天）
• --mode full：刷新当前 /llms.txt 范围内的所有页面
• --mode sync：同步 /llms.txt 范围 → 创建缺失的占位文件并重建索引（不抓取页面）
• --prune（可选）：移除不再位于 /llms.txt 范围内的本地页面
• --seed-max-age-days <n>（可选）：调整 seed 模式的新鲜度时限（0 = 始终刷新，<0 = 禁用按时限刷新）
• --mode index：仅重建 __SNAPSHOT_INDEX.(md|json)
• --mode single --url <url>：抓取一个页面，并将其映射到 references/docs/**

可选本地化（尽力而为，默认回退到英语）：

./scripts/update.sh --mode seed --locale zh-CN

建议定期执行的清理命令：

./scripts/update.sh --mode sync --prune

试运行验证（不写入任何文件，包括索引文件）：

./scripts/update.sh --mode full --dry-run --prune

需要 Node.js >= 18。

搜索社区技能

从 awesome-clawdbot-skills 搜索社区构建的 OpenClaw/Clawdbot 技能：

cd tool-openclaw
# If you are working inside this repo instead of an installed skill:
# cd skills/tool-openclaw
./scripts/search-skills.sh discord      # Search by keyword
./scripts/search-skills.sh pdf document # Multiple keywords
./scripts/search-skills.sh --list       # List categories
./scripts/search-skills.sh --refresh    # Force refresh cache

安装找到的技能：npx clawdhub@latest install <skill-slug>

资源

• 快照精选导航：references/entrypoints.md
• 迁移审计提示词和报告格式：references/model-migration-audit.md
• 故障排查手册：references/troubleshooting.md
• 快照说明和刷新：references/docs_snapshot.md