从安装部署到初始化配置、ClawHub、联网、自动化与常用应用场景,帮助中文用户一步一步把 OpenClaw 真正用起来。
很多人第一次接触 OpenClaw,最容易卡住的不是“它能做什么”,而是:
- 不知道该怎么装
- 不知道 API 应该怎么配
- 不知道本地、WSL、Docker、第三方平台到底怎么选
- 装好之后,不知道从哪里开始真正把它用起来
这个仓库就是为这些问题准备的。
它不是一份只讲概念的速览,而是一套偏实操、偏中文语境、偏普通用户上手路径的教程集合。你可以把它理解成一份 OpenClaw 中文电子手册雏形。
总入口:
如果你是第一次接触 OpenClaw,建议按下面顺序阅读:
- 先看 介绍
- 安装路线优先选:
- 安装完成后先看 OpenClaw 必做的初始化配置
- 再继续看 ClawHub 指南 和 应用场景目录
- 理解 OpenClaw 到底适合拿来做什么,而不只是把它当成另一个聊天工具
- 了解 Windows、WSL、Docker、第三方平台几种典型安装路线的差异
- 学会把常见模型和 API 接入 OpenClaw
- 能把 OpenClaw 接到飞书、QQ、企业微信、微信等 IM 平台
- 理解
SOUL.md、IDENTITY.md、USER.md、ClawHub、Skills、工作区这些概念在实际使用里的作用 - 通过一组应用场景看懂 OpenClaw 的“连接器 / 胶水层”逻辑
下面这张表把当前安装教程按几个维度做了标注:
API配置:是否包含模型或平台 API 配置推荐度:面向新手上手的主观建议,五星最高环境:偏本地、云,还是两者都能参考安全性:仅作为上手层面的相对建议,不代表严格安全审计结论IM接入:是否包含 QQ / 飞书 / 企业微信 / 微信等接入内容
| 教程 | 推荐度 | 适用的操作系统 | API配置 | 环境 | 安全性 | IM接入 |
|---|---|---|---|---|---|---|
| clawX安装openclaw(qq、飞书、企微、微信) | ★★★★★ | Windows | 有 | 本地 | 中 | QQ / 飞书 / 企业微信 / 微信 |
| Windows-WSL-飞书群聊入门 | ★★★★☆ | Windows | 有 | 本地 | 中 | 飞书 |
| Kimi Claw 与本地 OpenClaw 飞书接入教程 | ★★★★☆ | Windows / macOS / 云端 | 有 | 本地 / 云均可 | 中 | 飞书 |
| Windows WSL2 + GLM API 接入 OpenClaw | ★★★★☆ | Windows | 有 | 本地 | 中 | 无 |
| LM Studio qwen3.5本地模型接入 OpenClaw | ★★★★☆ | Windows | 有 | 本地 | 中 | 无 |
| openclaw docker配置 | ★★★☆☆ | Windows / macOS / Linux | 有 | 本地 | 高 | 飞书 |
| Step 3.5 Flash API Key 与 OpenClaw 配置 | ★★★☆☆ | Windows / macOS / Linux / 云端 | 有 | 本地 / 云均可 | 中 | 无 |
| 火山豆包模型接入 OpenClaw | ★★★☆☆ | Windows / macOS / Linux | 有 | 本地 | 中 | 无 |
| 火山 Coding Plan 小白配置教程 | ★★★☆☆ | Windows / macOS | 有 | 本地 | 中 | 无 |
| 阿里云 Coding Plan 接入 OpenClaw | ★★★☆☆ | Windows / macOS / Linux | 有 | 本地 | 中 | 无 |
| macos虚拟机隔离安装 OpenClaw | ★★☆☆☆ | macOS | 无 | 本地 | 高 | 无 |
| 模块 | 说明 |
|---|---|
| 介绍 | 整体理解这个仓库的阅读路径,以及 OpenClaw 的定位 |
| OpenClaw 必做的初始化配置 | 理解 SOUL.md、IDENTITY.md、USER.md,先把助手调教成“你的助手” |
| ClawHub 指南 | 学会怎么搜索、安装、更新和安全使用 Skills |
| 15个OpenClaw应用场景 | 按场景理解 OpenClaw 的能力组合方式 |
- 01-个人知识库
- 02-定时任务
- 03-邮箱管理
- 04-任务管理
- 05-图片、视频生成
- 06-日程管理
- 07-自媒体文稿撰写
- 08-金融助手
- 09-代码开发助手
- 10-浏览器自动化
- 11-文件分析和生成(PDF-word-PPT-excel)
- 12-图表
- 13-动画生成(基于Remotion)
- 14-新闻汇总
- 15-论文科研
- 16-联网
这套内容更适合这样使用:
- 先跑通一条主链路,不要一开始就同时折腾模型、IM、Skills、自动化
- 先解决“能装、能配、能对话”
- 再解决“认主、联网、装技能”
- 最后再开始把多个能力组合起来用
如果你是普通用户:
- 优先看 WSL 或 ClawX
- 先接一个稳定模型
- 再接飞书或其他 IM
如果你更重视隔离和安全:
- 优先看 Docker 或虚拟机隔离方案
- 尽量把高权限运行环境和主力工作环境分开
- docs/doc/:当前主文档目录
- docs/doc/怎么安装openclaw/:安装、模型接入、IM 接入
- docs/doc/怎么使用openclaw/:初始化配置、ClawHub、应用场景
- docs/:用于 GitHub Pages / Docsify 的网页入口目录
如果你想在本地预览这个子项目的网页文档,可以在当前目录执行:
python -m http.server 8080然后打开:
http://localhost:8080/docs/
如果要部署到 GitHub Pages,推荐直接使用仓库分支目录发布:
Settings → Pages → Deploy from a branch → Branch: main → Folder: /docs
欢迎继续补充和完善这份中文教程:
- 补充更清晰的安装路径
- 修正文档中的过期步骤
- 增加更多 API / 模型 / 平台接入方案
- 增加新的使用场景和踩坑总结
提交前请注意:
- 不要提交真实密钥、Token、组织信息
- 涉及外部平台配置时,尽量写清前置条件和限制
本项目采用 Apache 2.0 协议。
