文档中心
如果你第一次打开 OpenClaw，不要急着把所有页面都看完。 先记住一句话：OpenClaw 是一个运行在你自己电脑或服务器上的 AI 助手总机。
它把 Telegram、WhatsApp、Slack、Discord、WebChat 等聊天入口接进来，再把消息交给后面的 AI 模型和工具去处理。你可以把它想成家里的“总开关”：灯、空调、门铃都接到这里，你只需要知道开关在哪。
先把 OpenClaw 跑起来
这些页面解决“我电脑上怎么有一个能工作的 OpenClaw”。
- 快速入门：最短路线，适合第一次安装
- 安装 OpenClaw：脚本安装、npm 安装、检查环境
- 安装向导：用
openclaw onboard --install-daemon一步步配置 - 基础设置：装好之后要检查什么
- 更新与回滚：以后升级时看这里
- Docker 部署：想放到服务器或容器里运行
- Nix 安装：适合熟悉 Nix 的用户
认识核心架构
这些页面解决“它到底是怎么工作的”。
- 通俗架构说明：用前台、总机、后厨的比喻理解 OpenClaw
- 系统架构设计：更适合开发者的源码级结构
- 功能特性：当前 OpenClaw 能做什么
- 智能体循环：一条消息从进来到回复出去的过程
- 会话管理：为什么 OpenClaw 能记住一段对话
- 多智能体路由：多个 AI 助手如何分工
- 模型故障转移：主模型不可用时如何切到备用模型
Web 控制 UI
新版 OpenClaw 很强调浏览器控制台。它不是装饰品，而是日常管理入口。
- Web 控制 UI 总览：从浏览器查看网关、频道、会话和配置
- 默认地址：
http://127.0.0.1:18789/ - 常用命令：
openclaw dashboard
如果你不知道现在 OpenClaw 有没有跑起来，先打开这里看一眼，通常比翻日志更直观。
网关与运维
网关是 OpenClaw 的“总机”。它负责收消息、分发任务、管理频道、连接节点、保存运行状态。
- 网关运维手册：状态检查、启动停止、重启和常用命令
- 配置文件：OpenClaw 的配置放在哪里、怎么改
- 配置示例：照着改的样板
- 发现与传输：本机和局域网里如何找到网关
- 配对：设备和网关如何建立信任
- 远程访问：把 OpenClaw 放到服务器时要注意什么
- 安全：不要把总机裸奔到公网
- 网关故障排查：启动失败、断连、端口占用
聊天频道
频道就是 OpenClaw 和外界说话的“门口”。你可以只开一个频道，也可以同时开很多个。
- 频道总览：不知道选哪个入口时先看这里
- Telegram：新手最推荐，配置清楚，反馈快
- WhatsApp：适合手机即时通讯场景
- Discord：适合社区、群组和开发者服务器
- Slack：适合团队协作
- Signal：适合更重视隐私的用户
- BlueBubbles / iMessage：适合 Apple 生态
- Mattermost、Matrix、Teams：适合团队和自托管协作场景
频道在新版 OpenClaw 中多由插件承载。普通用户只需要知道：能在向导里启用的，就按向导来；向导找不到的，再看对应插件说明。
AI 模型和提供商
模型提供商就是 OpenClaw 后面的“AI 大脑”。OpenClaw 负责调度，真正写代码、总结、分析的是模型。
- 选择 AI 大脑：新手从这里开始
- OpenAI：OpenAI API 和兼容端点
- Anthropic：Claude 系列模型
- OpenRouter：一个入口访问多家模型
- Ollama：在自己电脑上跑本地模型
- vLLM：自托管高性能推理
- LiteLLM：统一代理多家模型
- 自定义模型提供商：接入 OpenAI 兼容或 Anthropic 兼容服务
工具、插件与节点
工具让 AI 不只会聊天，还能做事。插件让 OpenClaw 能扩展新能力。节点让手机、桌面应用或远程设备也能参与进来。
- 工具系统：浏览器、命令、网页、画布、技能等能力概览
- 插件专题：理解
openclaw.plugin.json、能力注册和插件加载 - 浏览器工具：让 Agent 操作网页
- Exec 命令工具：让 Agent 在允许范围内运行命令
- 技能系统：给 Agent 加一份“做事说明书”
- 子智能体：把复杂任务拆给多个 Agent
- 节点总览：手机、桌面或远程设备如何连接网关
- Canvas 工具：在节点上展示交互式画布
自动化
自动化适合“到点做”“有事件就做”“外部系统通知后做”的任务。
- 自动化总览：先理解 Hooks、Cron、Webhook、Heartbeat
- Hooks 事件钩子：系统发生事情时自动触发
- Cron 定时任务：每天、每周、每小时运行
- Cron vs Heartbeat：什么时候用哪一种
- 后台任务 Tasks：查看后台任务是否成功
- Task Flow 任务流：跟踪多步骤流程
- Standing Orders 长期指令：给 Agent 长期授权和边界
- Webhook：让 GitHub、监控系统或其他服务触发 OpenClaw
- 自动化故障排查：任务不执行时从哪里查
源码剖析
如果你不只是想用，还想读懂 OpenClaw 源码，可以走这两条线。
这两部分不是官方文档翻译，而是本站按“慢慢讲清楚”的方式整理的源码导读。
遇到问题
记住一个最朴素的排查顺序：
bash
openclaw doctor
openclaw gateway status
openclaw dashboard先确认环境，再确认网关，最后进浏览器看状态。这样最省力。