文档
文档
欢迎来到 OpenClaw 中文文档！
🚀 按场景选择你的起点
| 我想… | 推荐路径 | 预计耗时 |
|---|---|---|
| 快速体验，先跑起来 | 快速开始 → 向导配置 | 5 分钟 |
| 接入微信/企业微信 | 渠道指南 → Feishu | 10 分钟 |
| 使用国产大模型 | 模型配置 → 国产模型 | 15 分钟 |
| 部署到服务器 | Gateway → 远程部署 | 30 分钟 |
| 打造私人 AI 助手 | Agent 调教 → 工作区 | 1 小时+ |
📚 学习路线建议
新手路线（第一天）
进阶路线（第一周）
- 接入常用渠道 → 渠道配置
- 配置模型和故障转移 → Provider 指南
- 让 AI 能执行任务 → 工具系统
深度路线（第一月）
- 调教专属 Agent → Agent 工作区
- 自动化工作流 → Cron / Hooks
- 生产环境部署 → Gateway 运维
💡 实战场景
个人效率
- 消息聚合：把 WhatsApp、Telegram、企业微信的消息统一到一个 AI 助手
- 智能提醒：结合 Gmail 和日历，自动生成每日任务清单
- 知识检索：通过 Web 工具搜索资料，自动整理摘要
团队协作
- 客服机器人：接入企业渠道，自动回复常见问题
- 内容审核：监听群消息，自动标记重要信息
- 定期报告：Cron 定时抓取数据，生成周报发送到群
开发者工具
- 代码审查：接收 GitHub Webhook，AI 分析代码变更
- CI/CD 通知：构建失败时自动通知，附带错误分析
- API 测试：通过聊天触发 Web 工具，测试接口状态
⚠️ 常见坑点
新手常踩的坑
| 坑点 | 解决方案 |
|---|---|
| Gateway 无法启动 | 检查端口占用：openclaw doctor |
| 渠道收不到消息 | 确认渠道已启用且账号已配对 |
| 模型调用失败 | 先用 openclaw models status --probe 排查 |
| 远程连接被拒绝 | 检查 Gateway 认证配置 |
进阶用户注意
🎯 核心概念速览
Gateway（网关）
中央进程，管理所有渠道和 AI 交互。支持本地运行和远程部署，是安全边界的关键。
Agent（智能体）
AI 助手的"大脑"，通过工作区文件定义能力边界、记忆范围和交互风格。
Channels（渠道）
用户交互入口，支持 WhatsApp、Telegram、Discord、Feishu 等主流平台。
Tools（工具）
Agent 的"手"，浏览器控制、文件操作、系统命令、自动化能力。
Providers（模型）
配置 AI 模型，支持 Claude、GPT、国产大模型和本地模型（Ollama/vLLM）。
📖 文档导航
入门区
核心区
进阶区
生产区
- Gateway — 配置、远程访问、安全、诊断
参考区
💬 获取帮助
- 常见问题：FAQ
- 故障排除：排障指南
- GitHub Issues：提交问题
- 中文社区：GitHub Discussions