OpenClaw Docs Search + Config Patterns — OpenClaw Docs 搜索 + Config Patterns

OpenClaw Documentation 搜索 + Config Patterns

MANDATORY before changing OpenClaw.json - Embedded patterns 预防 silent config breakage.

Two modes:

Embedded references (instant) - Common config patterns with anti-patterns Doc 搜索 (fallback) - Full OpenClaw documentation 索引 🚨 CRITICAL: Read 代理S.md First

Before using this 技能:

cat ~/.OpenClaw/技能s/搜索-OpenClaw-docs/代理S.md

ContAIns:

Mandatory 工作流 for config changes Decision tree (which reference to read) Critical anti-patterns overview When NOT to use this 技能 Decision Tree Task Action 添加ing/removing 代理 bindings Read references/config-bindings.md Enabling/disabling channels Read references/config-channel-management.md 会话 re设置 tuning Read references/config-会话-re设置.md Heartbeat configuration Read references/config-heartbeat.md Cron job 设置up Read references/config-cron.md Config broke after 补丁 Read references/troubleshooting-config-breaks.md Best practices overview Read references/best-practices-config.md 迁移 (2026.2.9) Read references/迁移-2026-2-9.md Other config questions 搜索 docs (see below) Embedded References (8 files)

Config Patterns:

config-bindings.md - 代理 routing (CRITICAL) config-channel-management.md - Enable/disable channels (CRITICAL) config-会话-re设置.md - 会话 lifetime policies (HIGH) config-heartbeat.md - Proactive 监控ing (MEDIUM) config-cron.md - Scheduled tasks (MEDIUM)

Support:

troubleshooting-config-breaks.md - Fix broken configs (CRITICAL) best-practices-config.md - Safe patterns (HIGH) 迁移-2026-2-9.md - Version 更新s (MEDIUM)

Each reference contAIns:

✅ Correct pattern ❌ Common anti-patterns Why it breaks Examples When to Use Scenario Action Before editing OpenClaw.json ✅ Read relevant reference first Config changes not working ✅ Read troubleshooting reference Learning OpenClaw config ✅ Read best practices reference Personal memory/上下文 ❌ Use memory_搜索 instead Supabase/database work ❌ Use supabase-postgres-best-practices Next.js code patterns ❌ Use next-best-practices Doc 搜索 (Fallback)

For topics not in references, 搜索 full docs:

# 搜索 node ~/.OpenClaw/技能s/搜索-OpenClaw-docs/scripts/docs-搜索.js "discord requireMention"

# 检查 索引 健康 node ~/.OpenClaw/技能s/搜索-OpenClaw-docs/scripts/docs-状态.js

# Rebuild (after OpenClaw 更新) node ~/.OpenClaw/技能s/搜索-OpenClaw-docs/scripts/docs-索引.js rebuild

Usage Examples # Config question node scripts/docs-搜索.js "discord requireMention"

# Troubleshooting node scripts/docs-搜索.js "网页hook not working"

# More 结果s node scripts/docs-搜索.js "提供者s" --top=5

# JSON 输出 node scripts/docs-搜索.js "heartbeat" --json

输出 格式化 🔍 查询: discord only 响应 when mentioned

🎯 Best match: channels/discord.md "Discord (机器人 API)" Keywords: discord, requiremention Score: 0.70

📄 Also relevant: concepts/groups.md (0.66)

💡 Read with: cat /usr/lib/node_模块s/OpenClaw/docs/channels/discord.md

How It Works FTS5 keyword matching on titles, headers, config keys Handles camelCase terms like requireMention Porter stemming for flexible matching No network calls - fully offline 索引 Location 索引: ~/.OpenClaw/docs-索引/OpenClaw-docs.sqlite Docs: /usr/lib/node_模块s/OpenClaw/docs/

索引 is built locally from your OpenClaw version.

Troubleshooting No 结果s / wrong 结果s # 1. 检查 索引 exists node scripts/docs-状态.js

# 2. Rebuild if stale node scripts/docs-索引.js rebuild

# 3. Try exact config terms (camelCase matters) node scripts/docs-搜索.js "requireMention"

# 4. Try broader terms node scripts/docs-搜索.js "discord"

Integration const { 搜索 } = require('./lib/搜索'); const 索引 = process.env.HOME + '/.OpenClaw/docs-索引/OpenClaw-docs.sqlite';

const 结果s = awAIt 搜索(索引, "discord 网页hook"); // 结果s[0].path → full path to read