用途:帮助用户完成 OpenClaw 的安装、配置、运行与迁移,覆盖网关(gateway)、频道(whatsapp/telegram/discord/mattermost/imessage)、节点与 Web 界面、远程访问(ssh/tailscale)、认证/OAuth、模型迁移与提供商切换、沙箱与工具策略等主题。
主要能力:以 references/docs/ 下的离线文档快照为唯一事实来源,按用户报错原文或具体命令/配置键做 grep 式检索,打开 1-2 个相关页面提取准确命令与配置字段,再按固定模板输出诊断、所查文档、步骤、验证方式与后续排查所需信息。模型/提供商迁移时先检查本地环境,识别当前模型路径、认证模式与运行时通道,把迁移视为通道问题而非仅模型 ID 问题,并使用 references/model-migration-audit.md 的提示与报告结构。
使用方式:先做问题分类,再检索快照;常用入口包括 references/docs/start/getting-started.md、start/wizard.md、gateway/configuration.md、gateway/authentication.md、providers/anthropic.md、providers/openai.md、concepts/oauth.md、gateway/troubleshooting.md 等。快照更新需 Node.js >= 18,在 tool-openclaw 目录执行 ./scripts/update.sh --mode index 重建索引,常用模式有 seed、full、sync、index、single --url <url>,可加 --prune、--dry-run、--seed-max-age-days <n>,本地化可用 --locale zh-CN。社区技能检索用 ./scripts/search-skills.sh <关键词>,安装用 npx clawdhub@latest install <skill-slug>。
限制与安全:默认不写入任何文件;不得索取或回显密钥、令牌,用户提供的配置与日志需先脱敏;破坏性步骤(重置会话/状态、删除配置)必须明确提示并确认;除非文档明确说明并解释权衡,不推荐削弱认证与沙箱等安全默认值。快照缺失或过期时按 references/docs_snapshot.md 刷新。