OpenClaw 使用指南

OpenClaw 是一个开源的 AI 个人助手框架，通过 Gateway 连接多种频道（Telegram、Discord、WhatsApp、微信等），配合模型提供商（Kimi、GLM、OpenRouter 等）提供智能助手能力。

快速命令

| 需求 | 命令 | |------|------| | 查看状态 | openclaw status | | 切换模型 | /model kimi-coding/k2p5 | | 压缩上下文 | /compact | | 健康检查 | openclaw doctor | | 安全审计 | openclaw security audit [--fix] |

核心架构

• Gateway: WebSocket 服务器，管理频道/节点/会话/hooks
• Agent Loop: 用户消息 → 模型推理 → 工具调用 → 循环直到完成
• Context Engine: 系统提示 + 工作区文件 + 对话历史 + 心跳
• Compaction: 上下文接近窗口限制时自动压缩

文档导航

本 Skill 包含 212 篇 OpenClaw 官方文档完整内容，按目录组织：

核心概念 - references/concepts/

架构、Agent 循环、上下文引擎、模型故障转移、会话管理、记忆系统等 26 篇

Gateway - references/gateway/

配置、认证、安全、沙盒、心跳、远程访问、Tailscale、故障排除等 33 篇

CLI 命令 - references/cli/

所有子命令：config、gateway、models、sessions、devices、nodes、cron、security 等 46 篇

频道配置 - references/channels/

Telegram、Discord、WhatsApp、Signal、Slack、微信等各平台配置 29 篇

工具 - references/tools/

exec、browser、web、PDF、skills、subagents、thinking 等 25 篇

自动化 - references/automation/

cron 定时任务、webhook、hooks、投票、认证监控 11 篇

模型提供商 - references/providers/

Anthropic、GLM、Moonshot、OpenAI、OpenRouter、Ollama、Qwen 9 篇

入门指南 - references/start/

快速开始、安装、引导 5 篇

安全 - references/security/

威胁模型 1 篇

帮助 - references/help/

FAQ、调试、环境变量 4 篇

安装 - references/install/

Docker、Node.js、更新 4 篇

Web - references/web/

Dashboard、Control UI 3 篇

参考模板 - references/reference/

AGENTS.md、SOUL.md、BOOTSTRAP.md 等工作区模板 8 篇

其他

• overview.md — 项目概览
• index.md — 文档索引
• brave-search.md — 搜索配置
• ci.md — CI 集成
• tts.md — 语音合成
• vps.md — VPS 部署

使用建议

遇到具体问题时，直接查阅对应目录下的文档。例如：

• 配置 Telegram → references/channels/telegram.md
• 设置定时任务 → references/automation/cron-jobs.md + references/cli/cron.md
• 安全审计 → references/gateway/security/index.md + references/cli/security.md
• 模型配置 → references/concepts/models.md + references/cli/models.md