OpenClaw 完整教程 - 从入门到精通 🦞

OpenClaw 是一个强大的 AI Agent 框架，让你的 AI 助手拥有真正的"灵魂"。

📚 目录

快速开始
什么是 OpenClaw
核心概念
详细安装教程
配置指南
技能系统
多 Agent 协作
常见问题
最佳实践
贡献指南

🚀 快速开始

一键安装（推荐）

# 安装 OpenClaw
curl -fsSL https://openclaw.ai/install.sh | bash

# 启动 OpenClaw
openclaw start

验证安装

# 检查状态
openclaw status

# 查看版本
openclaw --version

第一个对话

安装完成后，直接在你的聊天平台（Discord、Telegram、钉钉等）中发送消息，OpenClaw 会自动响应！

🤔 什么是 OpenClaw

OpenClaw 是一个AI Agent 框架，它让大语言模型（LLM）不仅仅是聊天机器人，而是成为真正的数字助手。

核心特点

🧠 记忆系统 - 长期记忆 + 短期记忆，让 AI 记住你的偏好和历史
🛠️ 工具系统 - 文件操作、网页搜索、代码执行、浏览器控制等
📝 技能系统 - 可扩展的技能包，让 AI 学会专业能力
🤝 多 Agent 协作 - 多个 AI 助手分工合作，各司其职
⏰ 定时任务 - Cron 调度、心跳检查、自动提醒
🔒 安全机制 - 权限控制、沙箱执行、操作审计

与传统 Chatbot 的区别

特性	传统 Chatbot	OpenClaw
记忆	无/短期	长期 + 短期
工具	有限	丰富可扩展
技能	固定	动态安装
协作	单 Agent	多 Agent
自动化	手动触发	定时任务
安全	基础	多层防护

💡 核心概念

1. Agent（智能体）

Agent 是 OpenClaw 的核心单元，每个 Agent 都有：

身份 - SOUL.md 定义性格和行为准则
记忆 - MEMORY.md 和 daily notes 存储信息
工具 - 可执行的操作能力
技能 - 专业领域的知识包

2. 技能（Skill）

技能是 OpenClaw 的能力扩展包，包含：

SKILL.md - 技能定义和使用说明
脚本 - 执行具体任务的代码
资源 - 参考文档、配置文件等

示例技能：

openclaw-boss - AI 老板评价系统
file-search - 文件搜索工具
rememberall - 提醒系统
weather - 天气查询

3. ClawHub

ClawHub 是 OpenClaw 的技能商店，类似 npm 或 pip：

# 搜索技能
clawhub search 技能名称

# 安装技能
clawhub install 技能名称

# 更新技能
clawhub update

# 发布技能
clawhub publish

4. 多 Agent 系统

OpenClaw 支持多个 Agent 同时工作：

乙维斯 - 主 Agent，日常助手
DevBot - 开发专用 Agent
LearnerBot - 学习和总结专用

每个 Agent 有独立的工作空间和配置。

📦 详细安装教程

前置要求

操作系统: Linux / macOS / Windows (WSL2)
Node.js: v20+ (推荐 v22)
Git: 2.0+
Python: 3.8+ (部分技能需要)

方式一：一键安装脚本（推荐）

# 下载安装脚本
curl -fsSL https://openclaw.ai/install.sh -o openclaw-install.sh

# 执行安装
bash openclaw-install.sh

# 安装完成后重启终端

方式二：手动安装

1. 安装 Node.js

# 使用 nvm 安装（推荐）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 22
nvm use 22

# 验证
node --version  # 应该显示 v22.x.x
npm --version   # 应该显示 10.x.x

2. 安装 OpenClaw

# 全局安装
npm install -g openclaw

# 验证安装
openclaw --version

3. 初始化工作空间

# 创建工作空间
mkdir -p ~/.openclaw/workspace
cd ~/.openclaw/workspace

# 初始化
openclaw init

方式三：Docker 安装

# 拉取镜像
docker pull openclaw/openclaw:latest

# 运行容器
docker run -d \
  --name openclaw \
  -v ~/.openclaw:/root/.openclaw \
  -p 3000:3000 \
  openclaw/openclaw:latest

⚙️ 配置指南

1. 基础配置

配置文件位置：~/.openclaw/config.json

{
  "workspace": "/root/.openclaw/workspace",
  "model": {
    "default": "doubao/ark-code-latest",
    "fallback": ["zhipu/glm-5", "deepseek/deepseek-chat"]
  },
  "agents": {
    "main": {
      "name": "乙维斯",
      "workspace": "/root/.openclaw/workspace"
    },
    "dev": {
      "name": "DevBot",
      "workspace": "/root/.openclaw/dev-workspace"
    }
  }
}

2. 模型配置

OpenClaw 支持多个模型提供商：

豆包（默认）

{
  "provider": "doubao",
  "model": "ark-code-latest",
  "apiKey": "your-doubao-api-key"
}

智谱 AI

{
  "provider": "zhipu",
  "model": "glm-5",
  "apiKey": "your-zhipu-api-key"
}

DeepSeek

{
  "provider": "deepseek",
  "model": "deepseek-chat",
  "apiKey": "your-deepseek-api-key"
}

3. 渠道配置

Discord

{
  "channel": "discord",
  "botToken": "your-discord-bot-token",
  "guildId": "your-server-id"
}

Telegram

{
  "channel": "telegram",
  "botToken": "your-telegram-bot-token"
}

钉钉

{
  "channel": "dingtalk",
  "webhook": "your-dingtalk-webhook"
}

4. 环境变量

# 设置 API 密钥
export DOUBAO_API_KEY="your-key"
export ZHIPU_API_KEY="your-key"
export DEEPSEEK_API_KEY="your-key"

# 设置工作空间
export OPENCLAW_WORKSPACE="/root/.openclaw/workspace"

🛠️ 技能系统

技能结构

skill-name/
├── SKILL.md           # 技能定义（必需）
├── README.md          # 使用说明
├── package.json       # 项目配置
├── scripts/           # 脚本目录
│   └── main.py        # 主脚本
├── references/        # 参考文档
└── assets/            # 资源文件

SKILL.md 格式

---
name: 技能名称
version: 1.0.0
description: 技能描述
author: 作者名
---

# 技能使用说明

## 触发词
- 关键词 1
- 关键词 2

## 功能
功能描述...

## 示例
使用示例...

安装技能

# 从 ClawHub 安装
clawhub install skill-name

# 从 GitHub 安装
git clone https://github.com/user/skill-name.git \
  ~/.openclaw/workspace/skills/skill-name

# 本地安装
cp -r /path/to/skill ~/.openclaw/workspace/skills/

开发技能

mkdir -p ~/.openclaw/workspace/skills/my-skill
cd ~/.openclaw/workspace/skills/my-skill

创建 SKILL.md

cat > SKILL.md << 'EOF'
---
name: 我的技能
version: 1.0.0
description: 这是我的第一个技能
author: 我的名字
---

# 使用说明

触发词：帮我...

功能描述...
EOF

测试技能

在对话中触发技能关键词，验证功能。

发布到 ClawHub

clawhub publish

🤝 多 Agent 协作

配置多 Agent

在 config.json 中添加：

{
  "agents": {
    "main": {
      "name": "乙维斯",
      "workspace": "/root/.openclaw/workspace",
      "model": "doubao/ark-code-latest"
    },
    "dev": {
      "name": "DevBot",
      "workspace": "/root/.openclaw/dev-workspace",
      "model": "zhipu/glm-5",
      "trigger": ["@dev", "@开发", "@代码"]
    },
    "learner": {
      "name": "LearnerBot",
      "workspace": "/root/.openclaw/learner-workspace",
      "model": "zhipu/glm-5",
      "trigger": ["@learner", "@学习", "@总结"]
    }
  }
}

Agent 间通信

# 发送消息到另一个 Agent
sessions_send --sessionKey dev --message "请帮我分析这段代码"

# 查看 Agent 状态
subagents list

协作场景

代码审查 - DevBot 审查代码，主 Agent 总结
学习总结 - LearnerBot 整理笔记，主 Agent 分享
任务分工 - 复杂任务分解给多个 Agent

❓ 常见问题

Q1: 安装失败怎么办？

A: 检查以下几点：

Node.js 版本是否 >= 20
网络连接是否正常
权限是否足够（尝试 sudo）
查看详细错误日志

Q2: 如何切换模型？

A: 修改 config.json 中的 model.default，或临时使用：

openclaw model set zhipu/glm-5

Q3: 技能安装后不生效？

A:

检查技能目录是否在正确位置
确认 SKILL.md 格式正确
重启 OpenClaw: openclaw restart
查看日志：openclaw logs

Q4: 如何备份配置？

A:

# 备份整个工作空间
tar -czf openclaw-backup.tar.gz ~/.openclaw

# 恢复
tar -xzf openclaw-backup.tar.gz -C ~/

Q5: 多 Agent 如何避免冲突？

A:

使用不同的触发词
分配不同的工作空间
设置不同的模型
明确任务分工

🎯 最佳实践

1. 工作空间管理

主工作空间: ~/.openclaw/workspace - 日常使用
开发工作空间: ~/.openclaw/dev-workspace - 代码开发
学习工作空间: ~/.openclaw/learner-workspace - 学习总结

2. 记忆维护

定期清理和整理记忆文件：

# 查看记忆文件
ls -lh ~/.openclaw/workspace/memory/

# 整理长期记忆
# 将重要的 daily notes 提炼到 MEMORY.md

3. 技能管理

只安装需要的技能
定期更新技能
删除不用的技能
自己开发常用技能

4. 安全建议

不要泄露 API 密钥
谨慎授予执行权限
定期更新 OpenClaw
使用沙箱测试新技能

5. 性能优化

使用轻量级模型处理简单任务
复杂任务使用强大模型
定期清理日志文件
合理设置并发数

📖 进阶教程

3. 定时任务配置

详细教程：定时任务

4. 多 Agent 编排

详细教程：Agent 编排

🔗 相关资源

OpenClaw 官方文档: https://docs.openclaw.ai
ClawHub 技能市场: https://clawhub.com
GitHub 仓库: https://github.com/openclaw/openclaw
Discord 社区: https://discord.gg/clawd
示例技能: https://github.com/openclaw/skills

🤝 贡献指南

欢迎贡献！可以通过以下方式：

提交 Issue - 报告 bug 或提出建议
提交 PR - 修复问题或添加新功能
编写教程 - 分享使用经验
开发技能 - 丰富技能生态

贡献流程

# Fork 仓库
gh repo fork winston-s-team/openclaw-tutorial

# 克隆到本地
git clone https://github.com/your-username/openclaw-tutorial.git

# 创建分支
git checkout -b feature/your-feature

# 提交更改
git commit -m "feat: 添加新功能"

# 推送并创建 PR
git push origin feature/your-feature
gh pr create

📝 更新日志

v2026.2.26 (2026-02-26)

✨ 新增多 Agent 协作支持
🐛 修复记忆系统 bug
📝 改进文档

v2026.2.9 (2026-02-09)

✨ 新增 ClawHub 集成
🔒 增强安全机制
⚡ 性能优化

📄 许可证

MIT License - 详见 LICENSE

🙏 致谢

感谢所有 OpenClaw 的贡献者和用户！

特别感谢：

OpenClaw 核心团队
ClawHub 技能开发者
社区贡献者

最后更新：2026-03-06

维护者：winston-s-team

Name		Name	Last commit message	Last commit date
Latest commit History 2 Commits
docs		docs
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md

Folders and files

Latest commit

History

Repository files navigation