OpenClaw 🦞 从入门到精通
系统整理 OpenClaw 自托管 AI 智能体网关的完整知识体系,覆盖安装、配置、渠道接入、工具使用、节点管理等核心场景
OpenClaw 是什么?
OpenClaw 是一个自托管 Gateway 网关,将你喜爱的聊天应用(Discord、Telegram、WhatsApp、Signal、Slack、iMessage、Feishu 等)连接到 AI 编码智能体。你只需在自己的机器上运行一个 Gateway 进程,它就成为你的消息应用与 AI 助手之间的桥梁。
核心特点
| 特点 | 说明 |
|---|---|
| 自托管 | 运行在你的硬件上,数据完全可控 |
| 多渠道 | 一个 Gateway 同时服务多个聊天平台 |
| 智能体原生 | 专为工具使用、会话、记忆和多智能体路由设计 |
| 开源 | MIT 许可证,社区驱动 |
适合谁?
开发者和高级用户,希望拥有一个可以随时发消息的个人 AI 助手,同时不放弃对自己数据的控制。
知识库导航
| 章节 | 内容 | 核心知识点 |
|---|---|---|
| 一、概览与核心概念 | OpenClaw 是什么、工作原理、功能亮点 | 架构理解、核心能力 |
| 二、安装与快速开始 | 安装方式、onboarding、服务部署 | 5分钟启动 Gateway |
| 三、消息渠道配置 | WhatsApp、Telegram、Discord、Feishu 等渠道接入 | 渠道配对、群组管理 |
| 四、Gateway 网关运维 | 运行时模型、端口配置、热重载、服务生命周期 | 运维检查、故障诊断 |
| 五、工具与插件系统 | 内置工具、Skills、插件、工具配置 | exec、browser、web_search |
| 六、高级功能 | 节点管理、媒体处理、自动化、TTS | 节点配对、Canvas、摄像头 |
| 七、实战案例 | 个人助手设置、多智能体、远程部署 | 真实场景配置 |
| 八、常见问题 | 故障排除、Doctor 工具、环境变量 | 快速定位和解决问题 |
快速开始(5 分钟)
# 1. 安装
npm install -g openclaw@latest
# 2. 引导式设置 + 安装服务
openclaw onboard --install-daemon
# 3. 打开控制面板聊天
openclaw dashboard或连接一个渠道(Telegram 最快),然后通过手机聊天。
系统要求
- Node.js: 24(推荐)或 22.14+
- 操作系统: macOS、Linux、Windows(原生或 WSL2)
- API Key: 至少一个模型提供商的 API Key
- 时间: 5 分钟
本知识库基于 OpenClaw 官方文档(docs.openclaw.ai)整理,结合实战经验编写。