🦞 一本书玩转 OpenClaw：超级个体实战指南

龙虾 / 大龙虾 Claw 从零到上手：OpenClaw 中文教程，安装配置、飞书接入、Skills 扩展与实战案例，打造你的 AI 助手。

📝 最新文章

更多内容见 文章列表：

🎯 新手快速通道

根据你的情况选择路径：

有 Mac 电脑：

1. 第1章：认识 OpenClaw — 了解它能做什么
2. 第2章：Mac 本地部署 — 一行命令安装
3. 第9章：接入飞书 — 手机随时对话
4. 第3章：快速上手 — 发送第一条消息

没有 Mac / 想 24 小时运行：

1. 第1章：认识 OpenClaw — 了解它能做什么
2. 第2章：云端部署 — 5 分钟完成
3. 第9章：接入飞书 — 手机随时对话
4. 第3章：快速上手 — 发送第一条消息

🚨 版本升级重要提示

⚠️ 2026.3.7 版本：Gateway认证要求（Breaking Change）

OpenClaw 2026.3.7 Breaking Change：Gateway认证现在要求显式设置 gateway.auth.mode。你必须明确选择 token 或 password 认证方式，不再有「无认证」的默认选项。

配置方法：

在 ~/.openclaw/openclaw.json 中添加以下配置：

{
  "gateway": {
    "auth": {
      "mode": "token",  // 或 "password"
      "token": "your-secret-token"
    }
  }
}

⚠️ 重要提示：如果你从旧版本升级到 v2026.3.7 且没有配置认证，Gateway将拒绝启动。

快速修复（命令行）：

# 设置token认证
openclaw config set gateway.auth.mode token
openclaw config set gateway.auth.token "your-secret-token"

# 重启Gateway
openclaw gateway restart

🔧 2026.3.2 版本：AI变"哑巴"了？

问题现象：升级到 2026.3.2 后，OpenClaw只能聊天不能干活（文件管理、命令执行等工具功能全部失效）

问题原因：该版本将工具权限和聊天能力做了隔离，默认 profile 改为 messaging（纯聊天模式）

5种 profile 说明：

快速修复方法：

方法1：命令行修复（推荐）

适用于：有命令行环境（本地/虚拟机/云服务器）

# 查看当前profile
openclaw config get tools

# 如果不是full，切换为full
openclaw config set tools.profile full

# 重启Gateway生效
openclaw gateway restart

方法2：Web UI修复（无需编程）

适用于：不方便使用编程工具的环境（手机版等）

1. 访问 http://127.0.0.1:18789（或你的服务器IP）
2. 点击左侧「配置」
3. 切换到 Raw 格式
4. 找到 tools 配置项
5. 将 profile 改为 "full"

{
  "tools": {
    "profile": "full"
  }
}

6. 保存配置并重启Gateway

📖 关于本教程

⚠️ 版本说明：本教程基于 OpenClaw 2026.3.8 版本编写（已验证）。

💡 重要前提：OpenClaw 预装了 49 个内置技能（Skills），开箱即用，无需额外安装即可完成本教程大部分演示。

📚 教程目录

第一部分：零基础入门

第二部分：4 大核心功能

第三部分：进阶技能

第四部分：实战案例

附录：速查手册

基础附录（A-F）

高级附录（G-N）

安全指南

💰 成本参考

💡 使用国产大模型（DeepSeek、Kimi）可节省 50%—70% 成本。

🔗 官方资源

• OpenClaw 官网
• OpenClaw 官方文档
• ClawHub 技能市场

💖 支持项目

如果这个教程对你有帮助：

• ⭐ 给项目点个 Star
• 🔄 分享给需要的人
• 💬 提交 Issue 反馈问题
• 🤝 贡献你的经验和案例

最后更新：2026年3月10日 教程版本：v1.5 总字数：418,000字（正文267,000字 + 附录151,000字） 章节数：15章正文 + 14个附录 + 1个安全指南 适用 OpenClaw 版本：2026.3.7（推荐稳定版）