🚀
快速上手
简单版提供详细的图文教程，5 分钟完成安装配置
OpenClaw中文文档站
你的个人 AI 助手，任何操作系统，任何平台 🦞
Skip to content
📖 文档导航
👶 新手入门
第一次使用？从 新手入门 开始，5 分钟完成安装配置！
新手入门（简单版）
适合第一次使用 OpenClaw 的用户，提供详细的安装和配置指南。
| 平台 | 指南 | 说明 |
|---|---|---|
| 📥 | Windows 安装指南 | 详细的 Windows 安装步骤 |
| 🍎 | macOS 安装指南 | macOS 用户快速上手 |
| ⚙️ | 模型配置 | 配置 AI 模型（推荐 Node 24） |
| 📱 | 飞书接入 | 重点！ 飞书集成配置（已捆绑） |
| 💼 | 企业微信 | 企业微信集成 |
| 🌐 | Tailscale 远程访问 | 新增！ 安全的远程访问配置 |
| 🔄 | 自动更新器 | 新增！ 自动更新配置指南 |
👨💻 开发者文档
有开发经验？查看 开发者文档 深入定制 OpenClaw！
开发者文档（开发版）
适合有开发经验的用户，深入讲解高级配置和插件开发。
| 主题 | 指南 | 说明 |
|---|---|---|
| 🔌 | 插件开发 | 创建自定义技能 |
| 🖥️ | 本地模型 | 部署本地大模型 |
| ⚡ | 高级配置 | 深度定制 OpenClaw |
| 🔍 | 故障排除 | 常见问题解决 |
🌟 快速开始
⚠️ 安装前必读
Node.js 是前置依赖！OpenClaw 需要 Node.js 环境才能运行。
- 推荐版本: Node.js 24.x
- 最低要求: Node.js 22.16+ (LTS)
- 下载地址: https://nodejs.org/
请先安装 Node.js，然后再执行下面的安装命令。
推荐安装方式
bash
# 1. 确保已安装 Node.js
node --version
# 2. 运行安装脚本
curl -fsSL https://openclaw.ai/install.sh | bash配置和启动
bash
# 运行配置向导（推荐）
openclaw onboard --install-daemon
# 检查网关状态
openclaw gateway status
# 打开控制面板
openclaw dashboard可选：连接聊天渠道
bash
# 添加渠道（如飞书、WhatsApp 等）
openclaw channels add
# 查看配对请求
openclaw pairing list
# 批准配对
openclaw pairing approve <channel> <code>🔥 最新更新 (2026-03-18)
- ✅ Pi Agent 现为唯一支持的 coding agent
- ✅ 安装脚本 支持自动检测和升级
- ✅ 飞书插件 已捆绑，无需单独安装
- ✅ Tailscale 集成 支持安全的远程访问（Serve/Funnel 模式）
- ✅ 自动更新器 可选配置（默认关闭，支持 stable/beta/dev 频道）
- ✅ 22 个聊天渠道 完整支持（WhatsApp, Telegram, Discord, 飞书等）
- 📚 官方文档索引: https://docs.openclaw.ai/llms.txt (200+ 页面)
📖 新增中文文档
- Tailscale 远程访问配置指南 - 完整的 Serve/Funnel 模式说明
- 自动更新器配置指南 - 自动更新、版本回滚、频道切换
📞 获取帮助
- 📚 官方文档 - 英文官方文档（Mintlify）
- 📑 文档索引 - 完整文档列表（200+ 页面）
- 💬 Discord 社区 - 加入社区讨论
- 🐛 问题反馈 - 提交 Bug
- 🏥 健康检查 - 运行
openclaw doctor
🆕 新增官方文档类别
- ⏰ 自动化: Cron 定时任务、Webhooks、Gmail 推送、Hooks
- 🧠 高级概念: 上下文引擎、模型故障转移、会话压缩
- 🔒 安全: 威胁模型、形式化验证、密钥管理
- ☁️ 部署: DigitalOcean、Oracle Cloud、Railway、Render
📋 支持的聊天渠道
| 渠道 | 状态 | 渠道 | 状态 |
|---|---|---|---|
| ✅ | Feishu (飞书) | ✅ | |
| Telegram | ✅ | LINE | ✅ |
| Discord | ✅ | Mattermost | ✅ |
| Slack | ✅ | Nextcloud Talk | ✅ |
| Google Chat | ✅ | Nostr | ✅ |
| Signal | ✅ | Synology Chat | ✅ |
| iMessage | ✅ | Tlon | ✅ |
| BlueBubbles | ✅ | Twitch | ✅ |
| IRC | ✅ | Zalo | ✅ |
| Microsoft Teams | ✅ | WebChat | ✅ |
| Matrix | ✅ |
💡 提示：如果你是第一次使用，建议从 新手入门 开始！运行
openclaw doctor可以检查配置健康状况。