Skip to content

Commit e1805be

Browse files
Maynor996claude
Maynor996
and
claude
committed
fix: 修复LINKS-VALIDATION-REPORT.md中的文字乱码
- 修复"自动化工作流"中的"流"字乱码 - 修复"必装Skills清单"中的"单"字乱码 - 修复"验证方法"中的"证"字乱码 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
1 parent 6e6cc22 commit e1805be

2 files changed

Lines changed: 336 additions & 3 deletions

File tree

‎LINKS-VALIDATION-REPORT.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,7 @@
3333
| 第4章：本地文件管理神器 | `docs/02-core-features/04-file-management.md` | ✅ 有效 |
3434
| 第5章：个人知识库 | `docs/02-core-features/05-knowledge-management.md` | ✅ 有效 |
3535
| 第6章：日程管理 | `docs/02-core-features/06-schedule-management.md` | ✅ 有效 |
36-
| 第7章：自动化工作�� | `docs/02-core-features/07-automation-workflow.md` | ✅ 有效 |
36+
| 第7章：自动化工作流 | `docs/02-core-features/07-automation-workflow.md` | ✅ 有效 |
3737

3838
### ✅ 第三部分：进阶技能（4章+安全指南）
3939

@@ -63,7 +63,7 @@
6363
| 附录 | 文件路径 | 内容 | 状态 |
6464
|------|---------|------|------|
6565
| 附录A | `appendix/A-command-reference.md` | 命令速查表 | ✅ 有效 |
66-
| 附录B | `appendix/B-skills-catalog.md` | 必装Skills��单 | ✅ 有效 |
66+
| 附录B | `appendix/B-skills-catalog.md` | 必装Skills清单 | ✅ 有效 |
6767
| 附录C | `appendix/C-api-comparison.md` | API服务商对比 | ✅ 有效 |
6868
| 附录D | `appendix/D-community-resources.md` | 社区资源导航 | ✅ 有效 |
6969
| 附录E | `appendix/E-common-problems.md` | **常见问题速查** | ✅ 新增 |
@@ -122,7 +122,7 @@
122122
- 18个问题及解决方案
123123
- 安装、API、Gateway、Skills、平台集成、性能问题全覆盖
124124

125-
### 验��方法
125+
### 验证方法
126126
```bash
127127
# 验证所有章节文件存在
128128
for file in docs/**/*.md; do

‎index.md.backup‎

Lines changed: 333 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,333 @@
1+
---
2+
layout: default
3+
title: 首页
4+
---
5+
# 🦞 Awesome OpenClaw Tutorial
6+
# 🦞 一本书玩转 OpenClaw：超级个体实战指南
7+
8+
> 从零开始打造你的 AI 工作助手——最全面的中文教程，涵盖安装、配置、实战案例和避坑指南
9+
10+
[![GitHub stars](https://img.shields.io/github/stars/xianyu110/awesome-openclaw-tutorial?style=social)](https://github.com/xianyu110/awesome-openclaw-tutorial)
11+
[![GitHub forks](https://img.shields.io/github/forks/xianyu110/awesome-openclaw-tutorial?style=social)](https://github.com/xianyu110/awesome-openclaw-tutorial)
12+
[![License](https://img.shields.io/badge/license-GPL--3.0-blue.svg)](LICENSE)
13+
[![Version](https://img.shields.io/badge/version-v2026.3.12-green.svg)](https://github.com/xianyu110/awesome-openclaw-tutorial)
14+
[![Status](https://img.shields.io/badge/status-完成-success.svg)](PROJECT-SUMMARY.md)
15+
[![CSDN](https://img.shields.io/badge/CSDN-博客-c32136?style=for-the-badge&logo=csdn)](https://blog.csdn.net/xianyu120)
16+
[![Bilibili](https://img.shields.io/badge/Bilibili-B站-fb7299?style=for-the-badge&logo=bilibili)](https://space.bilibili.com/399102586)
17+
[![微信公众号](https://img.shields.io/badge/微信公众号-MaynorAI-07C160?style=for-the-badge&logo=wechat)](https://upload.may.maynor1024.live/file/1773461955906_qrcode_for_gh_c749803541de_1280.jpg)
18+
[![YouTube](https://img.shields.io/badge/YouTube-Profile-red?style=for-the-badge&logo=youtube)](https://www.youtube.com/@buguniao537)
19+
[![X](https://img.shields.io/badge/X-Profile-000000?style=for-the-badge&logo=x&logoColor=white)](https://x.com/Nikitka_aktikiN)
20+
21+
22+
## 📖 新书预告：《OpenClaw超级个体实操手册》
23+
24+
⚠️ **本教程早期内容存在AI生成未验证的问题**（[#34](https://github.com/xianyu110/awesome-openclaw-tutorial/issues/34)），正在分批修正中。
25+
26+
纸质书在此基础上做了**全面重写+逐条验证**：
27+
- 🔍 144条CLI命令对照官方文档逐条核对（教程中约60%已删除或修正）
28+
- ✅ 9套配置模板全部在v2026.3.7+实际跑通
29+
- 🛡️ 新增安全防护指南 + 国产Claw全景指南
30+
- 📦 7份随书附赠电子资料
31+
32+
**清华大学出版社**，即将上市。⭐Star本仓库第一时间通知！
33+
34+
---
35+
36+
## 🎯 新手快速通道
37+
38+
根据你的情况选择路径：
39+
40+
**有 Mac 电脑**：
41+
1. [第1章：认识 OpenClaw](docs/01-basics/01-introduction.md) — 了解它能做什么
42+
2. [第2章：Mac 本地部署](docs/01-basics/02-installation.md#mac本地部署推荐) — 一行命令安装
43+
3. [第9章：接入飞书](docs/03-advanced/09-multi-platform-integration.md#91-飞书bot配置) — 手机随时对话
44+
4. [第3章：快速上手](docs/01-basics/03-quick-start.md) — 发送第一条消息
45+
46+
**没有 Mac / 想 24 小时运行**：
47+
1. [第1章：认识 OpenClaw](docs/01-basics/01-introduction.md) — 了解它能做什么
48+
2. [第2章：云端部署](docs/01-basics/02-installation.md#云端一键部署) — 5 分钟完成
49+
3. [第9章：接入飞书](docs/03-advanced/09-multi-platform-integration.md#91-飞书bot配置) — 手机随时对话
50+
4. [第3章：快速上手](docs/01-basics/03-quick-start.md) — 发送第一条消息
51+
52+
---
53+
54+
## 🚨 版本升级重要提示
55+
56+
### 🎉 2026.3.12 版本：重大功能更新
57+
58+
**OpenClaw 2026.3.12 已发布！**（2026年3月13日）
59+
60+
#### 🎛️ Control UI 全面升级（Dashboard v2）
61+
- **模块化视图设计**：全新的概览、聊天、配置、Agent 和会话视图
62+
- **命令面板**：快速访问所有功能的命令面板（Command Palette）
63+
- **移动端优化**：新增底部标签栏，移动端体验大幅提升
64+
- **增强聊天工具**：斜杠命令、搜索、导出、置顶消息功能
65+
66+
#### ⚡ 快速模式（Fast Mode）支持
67+
- **OpenAI GPT-5.4**：会话级快速切换，支持 `/fast`、TUI、Control UI 和 ACP
68+
- **Anthropic Claude**：`/fast` 切换映射到 API-key 的 `service_tier` 请求
69+
- **本地模型加速**：Ollama、vLLM、SGLang 迁移至提供商插件架构
70+
71+
#### 🔌 Kubernetes 支持
72+
- **初始 K8s 安装路径**：包含原始清单和 Kind 设置
73+
- **企业级部署**：完整的 Kubernetes 部署文档
74+
75+
#### 🔒 安全增强（重要！）
76+
- **设备配对安全**：`/pair` 和 `openclaw qr` 使用短期引导令牌
77+
- **插件信任机制**：禁用隐式工作区插件自动加载，需要明确信任决定
78+
- **命令权限控制**：`/config` 和 `/debug` 要求发送者所有权
79+
- **网关认证强化**：清除共享令牌 WebSocket 连接的未绑定客户端声明
80+
81+
**升级命令**：
82+
```bash
83+
openclaw update && openclaw gateway restart
84+
```
85+
86+
👉 [查看完整发布说明](https://github.com/openclaw/openclaw/releases)
87+
88+
---
89+
90+
### ⚠️ 2026.3.7 版本：Gateway认证要求（Breaking Change）
91+
92+
**OpenClaw 2026.3.7 Breaking Change**：Gateway认证现在要求显式设置 `gateway.auth.mode`。你必须明确选择 `token` 或 `password` 认证方式，不再有「无认证」的默认选项。
93+
94+
**配置方法**：
95+
96+
在 `~/.openclaw/openclaw.json` 中添加以下配置：
97+
98+
```json
99+
{
100+
"gateway": {
101+
"auth": {
102+
"mode": "token", // 或 "password"
103+
"token": "your-secret-token"
104+
}
105+
}
106+
}
107+
```
108+
109+
**⚠️ 重要提示**：如果你从旧版本升级到 v2026.3.7 且没有配置认证，Gateway将拒绝启动。
110+
111+
**快速修复（命令行）**：
112+
113+
```bash
114+
# 设置token认证
115+
openclaw config set gateway.auth.mode token
116+
openclaw config set gateway.auth.token "your-secret-token"
117+
118+
# 重启Gateway
119+
openclaw gateway restart
120+
```
121+
122+
---
123+
124+
### 🔧 2026.3.2 版本：AI变"哑巴"了？
125+
126+
**问题现象**：升级到 2026.3.2 后，OpenClaw只能聊天不能干活（文件管理、命令执行等工具功能全部失效）
127+
128+
**问题原因**：该版本将工具权限和聊天能力做了隔离，默认 profile 改为 `messaging`（纯聊天模式）
129+
130+
**5种 profile 说明**：
131+
132+
| Profile | 功能说明 |
133+
|---------|---------|
134+
| `messaging` | 只能发消息、管理会话（光聊天不干活） |
135+
| `default` | 默认工具集（不含命令执行） |
136+
| `coding` | 编程相关工具 |
137+
| `full` | 完整工具集，包含命令执行（**推荐**） |
138+
| `all` | 所有工具全开 |
139+
140+
**快速修复方法**：
141+
142+
#### 方法1：命令行修复（推荐）
143+
144+
适用于：有命令行环境（本地/虚拟机/云服务器）
145+
146+
```bash
147+
# 查看当前profile
148+
openclaw config get tools
149+
150+
# 如果不是full，切换为full
151+
openclaw config set tools.profile full
152+
153+
# 重启Gateway生效
154+
openclaw gateway restart
155+
```
156+
157+
#### 方法2：Web UI修复（无需编程）
158+
159+
适用于：不方便使用编程工具的环境（手机版等）
160+
161+
1. 访问 `http://127.0.0.1:18789`（或你的服务器IP）
162+
2. 点击左侧「配置」
163+
3. 切换到 **Raw** 格式
164+
4. 找到 `tools` 配置项
165+
5. 将 `profile` 改为 `"full"`
166+
167+
```json
168+
{
169+
"tools": {
170+
"profile": "full"
171+
}
172+
}
173+
```
174+
175+
6. 保存配置并重启Gateway
176+
177+
---
178+
179+
## 📖 关于本教程
180+
181+
> ⚠️ **版本说明**：本教程基于 **OpenClaw 2026.3.12**版本编写（已验证）。
182+
183+
> 💡 **重要前提**：OpenClaw 预装了 **49 个内置技能（Skills）**，开箱即用，无需额外安装即可完成本教程大部分演示。
184+
185+
| 内容 | 数量 |
186+
|------|------|
187+
| 正文章节 | 15 章，约 267,000 字 |
188+
| 基础附录 | 7 个（A-F+F视频），约 91,000 字 |
189+
| 高级附录 | 8 个（G-N），约 50,000 字 |
190+
| 实战案例 | 70+ 个，可直接复用 |
191+
| 配置截图 | 50+ 张，手把手教学 |
192+
| 命令参考 | 100+ 条，完整速查表 |
193+
194+
---
195+
196+
## 📚 教程目录
197+
198+
### 第一部分：零基础入门
199+
200+
| 章节 | 核心内容 |
201+
|------|---------|
202+
| [第1章：认识 OpenClaw](docs/01-basics/01-introduction.md) | OpenClaw 是什么、能做什么、和 ChatGPT 的区别 |
203+
| [第2章：环境搭建](docs/01-basics/02-installation.md) | Mac/Windows/Linux 本地部署、云端一键部署、Docker 部署 |
204+
| [第3章：快速上手](docs/01-basics/03-quick-start.md) | 第一次对话、10 个常用命令、人设配置、模型选择 |
205+
206+
### 第二部分：4 大核心功能
207+
208+
| 章节 | 核心内容 |
209+
|------|---------|
210+
| [第4章：本地文件管理](docs/02-core-features/04-file-management.md) | 智能搜索、批量处理、自动整理、硬盘清理 |
211+
| [第5章：个人知识库](docs/02-core-features/05-knowledge-management.md) | 网页剪藏、PDF 解析、GitHub 追踪、跨设备同步 |
212+
| [第6章：日程管理](docs/02-core-features/06-schedule-management.md) | 截图识别、日历创建、批量导入、智能提醒 |
213+
| [第7章：自动化工作流](docs/02-core-features/07-automation-workflow.md) | 定时任务、网站监控、AI 日报、循环任务 |
214+
215+
### 第三部分：进阶技能
216+
217+
| 章节 | 核心内容 |
218+
|------|---------|
219+
| [第8章：Skills 扩展](docs/03-advanced/08-skills-extension.md) | ClawHub 市场、必装 Top10、Skills 双幻神、自定义开发 |
220+
| [第9章：多平台集成](docs/03-advanced/09-multi-platform-integration.md) | 飞书、企微、钉钉、QQ 接入；多机器人、多 Agent 配置 |
221+
| [第10章：API 服务集成](docs/03-advanced/10-api-integration.md) | AI 绘图、Notion 同步、视频生成、语音合成 |
222+
| [第11章：高级配置](docs/03-advanced/11-advanced-configuration.md) | 多模型切换、成本优化、性能调优 |
223+
224+
### 第四部分：实战案例
225+
226+
| 章节 | 核心内容 |
227+
|------|---------|
228+
| [第12章：5 类人群效率提升](docs/04-practical-cases/12-personal-productivity.md) | 知识工作者、程序员、创作者、学生、超级个体实战 |
229+
| [第13章：高级自动化工作流](docs/04-practical-cases/13-advanced-automation.md) | 多 Skills 组合、知识图谱、Coding Agent、多 Agent 头脑风暴 |
230+
| [第14章：创意应用探索](docs/04-practical-cases/14-creative-applications.md) | AI 绘画、视频脚本、多语言翻译、数据分析 |
231+
| [第15章：超级个体实战](docs/04-practical-cases/15-solo-entrepreneur-cases.md) | 一人公司运营、自由职业、个人品牌、成本控制 |
232+
233+
### 附录：速查手册
234+
235+
#### 基础附录（A-F）
236+
237+
| 附录 | 内容 |
238+
|------|------|
239+
| [附录A：命令速查表](appendix/A-command-reference.md) | 100+ 常用命令，5 大类快速查找 |
240+
| [附录B：必装 Skills 清单](appendix/B-skills-catalog.md) | Top10 必装技能，附安装教程 |
241+
| [附录C：API 服务商对比](appendix/C-api-comparison.md) | 10+ 服务商价格对比，帮你省钱 |
242+
| [附录D：社区资源导航](appendix/D-community-resources.md) | 官方文档、视频教程、交流群 |
243+
| [附录E：常见问题速查](appendix/E-common-problems.md) | 安装/API/Skills/性能问题解决 |
244+
| [附录F：避坑指南与最佳实践](appendix/F-best-practices.md) | 新手必看，前人经验总结 |
245+
246+
#### 视频教程附录（F）
247+
| [附录F：配套实操视频指南](appendix/F-video-tutorials.md) | 7个视频教程链接，包含部署、接入和高级配置 |
248+
249+
#### 高级附录（G-N）
250+
251+
| 附录 | 内容 |
252+
|------|------|
253+
| [附录G：文档链接验证](appendix/G-links-validation.md) | 所有链接状态检查 |
254+
| [附录H：配置文件模板](appendix/H-config-templates.md) | 开箱即用的配置示例 |
255+
| [附录I：思考题参考答案](appendix/I-thinking-questions-answers.md) | 各章节思考题详解 |
256+
| [附录J：飞书配置检查清单](appendix/J-feishu-checklist.md) | 确保飞书Bot配置完整，避免常见问题 |
257+
| [附录K：API Key 配置完整指南](appendix/K-api-key-config-guide.md) | 多种API Key配置方式详解 |
258+
| [附录L：配置文件结构完整指南](appendix/L-config-file-structure.md) | 全局配置、Agent配置、认证配置详解 |
259+
| [附录M：搜索功能使用指南](appendix/M-search-guide.md) | 搜索功能使用��巧和常见问题 |
260+
| [附录N：Skills 生态说明](appendix/N-skills-ecosystem.md) | 内置49个、官方93个、社区1715+个Skills介绍 |
261+
262+
---
263+
264+
## 💰 成本参考
265+
266+
| 方案 | 月费用 | 适用场景 |
267+
|------|--------|---------|
268+
| 本地部署（有 Mac） | 0 元 | 隐私优先，功能最全 |
269+
| 云端（火山引擎） | 9.9 元起 | 飞书用户首选 |
270+
| 云端（腾讯云） | 20 元起 | 新手推荐 |
271+
| API（DeepSeek） | 5—30 元 | 日常使用，性价比最高 |
272+
| API（Kimi） | 10—50 元 | 长文档处理 |
273+
274+
💡 使用国产大模型（DeepSeek、Kimi）可节省 **50%—70%** 成本。
275+
276+
---
277+
278+
## 🔗 官方资源
279+
280+
- [OpenClaw 官网](https://openclaw.ai)
281+
- [OpenClaw 官方文档](https://docs.openclaw.ai)
282+
- [ClawHub 技能市场](https://clawhub.ai)
283+
- [GitHub 仓库](https://github.com/xianyu110/awesome-openclaw-tutorial)
284+
285+
---
286+
287+
## 📮 联系方式
288+
289+
### 社交媒体
290+
- **GitHub**: [@xianyu110](https://github.com/xianyu110)
291+
- **CSDN专栏**: [OpenClaw从入门到精通](https://blog.csdn.net/xianyu120/category_13126767.html)
292+
- **B站**: [@MaynorAI](https://space.bilibili.com/399102586)
293+
- **YouTube**: [@buguniao537](https://www.youtube.com/@buguniao537)
294+
- **X (Twitter)**: [@Nikitka_aktikiN](https://x.com/Nikitka_aktikiN)
295+
- **微信公众号**: [扫码关注](https://upload.maynor1024.live/file/1773461955906_qrcode_for_gh_c749803541de_1280.jpg)
296+
297+
### 项目链接
298+
- **Clawbot项目**: [700+ Stars](https://github.com/xianyu110/clawbot)
299+
- **两万人AI社区主理人**
300+
301+
---
302+
303+
## 👥 交流群
304+
305+
欢迎加入OpenClaw交流群，与更多开发者一起交流学习！备注：小龙虾
306+
307+
<div align="center">
308+
<img src="https://upload.maynor1024.live/file/1772695436136_20260305152343578.jpg" alt="OpenClaw交流群二维码" width="300">
309+
<p>扫码加入OpenClaw交流群</p>
310+
</div>
311+
312+
---
313+
314+
## 💖 支持项目
315+
316+
如果这个教程对你有帮助：
317+
- ⭐ 给项目点个 Star
318+
- 🔄 分享给需要的人
319+
- 💬 提交 Issue 反馈问题
320+
- 🤝 贡献你的经验和案例
321+
322+
---
323+
324+
<div align="center">
325+
<p>🎉 完全免费 | 持续更新 | 社区驱动 🎉</p>
326+
<p>🚀 一个人 + OpenClaw = 无限可能 🚀</p>
327+
</div>
328+
329+
**最后更新**：2026年3月17日
330+
**教程版本**：v1.6
331+
**总字数**：408,000字（正文267,000字 + 附录141,000字）
332+
**章节数**：15章正文 + 15个附录
333+
**适用 OpenClaw 版本**：2026.3.12（推荐最新版）

0 commit comments

Comments
 (0)