Yofer's Home

# OpenClaw 完全指南 (2026年完整版)

# 🦞 什么是 OpenClaw？

OpenClaw 是一个开源的 AI 主动智能体，连接 AI 模型与本地文件和消息传递平台。它是一种自我驱动、多任务协作的 AI 系统，可以自主完成复杂的数字任务。

前身项目：

  • MoltBot → Clawdbot → OpenClaw（因 Claude 名称限制而改名为 OpenClaw）

# 核心特性

  • 🔗 多平台消息集成（Telegram, WhatsApp, Discord, 微信）
  • 🧠 本地持久化记忆（任务、笔记、偏好设置）
  • 🛠️ 专业技能扩展（浏览器自动化、文件操作、命令执行）
  • 📦 Docker 隔离运行（安全沙箱环境）
  • 🚀 支持自定义技能开发

# 能帮你做什么？

  • 📝 创建和管理待办事项
  • 📊 分析数据和信息
  • 📧 自动回复消息
  • 🔍 进行网络搜索
  • 🤖 管理多个 AI Agent
  • 🛠️ 自动化开发任务

# 📋 安装要求

# 系统要求

组件 最低版本 推荐版本
Node.js 22+ 24+
操作系统 Linux/macOS/WSL2 Ubuntu 24.04 LTS
Docker 20.10+ 4.37.1+
内存 2GB 4GB+
磁盘 1GB 5GB+

# 检查环境

# 检查 Node.js 版本
node --version  # 应该 >= 22

# 检查 Docker 版本
docker --version  # 应该 >= 20.10

# 检查 Docker Compose 版本
docker compose version

# 🚀 安装步骤

# 方法 1：官方安装脚本（推荐）

# 下载并运行安装脚本
curl -fsSL https://openclaw.bot/install.sh | bash openclaw onboard --install-daemon

# 完成引导设置
openclaw onboard

# 方法 2：手动安装

# 克隆仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# 安装依赖
npm install

# 启动 OpenClaw
npm run dev

# 验证安装

# 检查 OpenClaw 版本
openclaw version

# 查看运行状态
openclaw status

# ⚙️ 配置指南

# 配置文件结构

~/.openclaw/
├── config.yaml          # 主配置文件
├── memory/              # 记忆目录
├── workspace/           # 工作区
│   └── skills/         # 技能库
└── logs/               # 日志文件

# 核心配置示例

# config.yaml

# 消息网关配置
gateway:
  channels:
    - platform: telegram
      token: "YOUR_TELEGRAM_BOT_TOKEN"
    - platform: whatsapp
      account: "YOUR_PHONE_NUMBER"
      api_key: "YOUR_WHATSAPP_API_KEY"

# AI 模型配置
models:
  main:
    provider: "openai"
    model: "gpt-4.1"
    api_key: "YOUR_API_KEY"

  subagents:
    - provider: "anthropic"
      model: "claude-3.5"
      capacity: 3

# 沙箱配置
sandbox:
  mode: "non-main"  # off | non-main | all
  docker:
    image: "openclaw-sandbox:bookworm-slim"
    memory: "1g"
    cpus: 1

# Docker 环境配置

# docker-setup.sh
export OPENCLAW_IMAGE="openclaw-sandbox:bookworm-slim"
./docker-setup.sh

# 🔐 安全配置

# Docker 沙箱限制

sandbox:
  docker:
    readOnlyRoot: true
    network: "none"
    user: "1000:1000"
    capDrop: ["ALL"]
    pidsLimit: 256
    memory: "1g"
    memorySwap: "2g"
    seccompProfile: "/etc/openclaw/seccomp.json"
    apparmorProfile: "openclaw-sandbox"

# 防御措施

  1. 网络隔离：沙箱网络设置为 none
  2. 权限限制：只读根文件系统
  3. 进程限制：最多 256 个进程
  4. 内存限制：1GB 内存，2GB Swap
  5. 用户隔离：运行为非 root 用户

# 📚 使用指南

# 基础命令

# 检查状态
openclaw status

# 查看日志
openclaw logs

# 重新加载配置
openclaw reload

# 进入交互模式
openclaw chat

# 与 AI 交互

通过 WhatsApp/Telegram/微信 发送消息：

你: 帮我创建一个待办事项列表
Agent: 好的，让我来创建待办事项...

你: 分析这个文件的代码
Agent: 正在分析文件...

你: 调用一个定时任务
Agent: 任务已创建并安排...

# 使用技能

# 列出所有技能
openclaw skills list

# 安装第三方技能
npx skills add openclaw-agent-skills

# 创建自定义技能
openclaw skills create my-skill

# 🚀 快速开始示例

# 示例 1：个人助理

# 1. 在 Telegram 中添加你的 OpenClaw Bot
# 2. 发送消息：帮我创建一个待办事项列表
# 3. Agent 会自动创建并保存待办事项到本地记忆

# 示例 2：开发助手

# 1. 配置好代码仓库的 GitHub 访问令牌
# 2. 发送消息：帮我分析这个项目的代码结构
# 3. Agent 会分析代码并生成报告

# 示例 3：自动化任务

# 1. 设置定时任务
# 2. Agent 会自动执行任务

# 🎯 典型应用场景

# 1. 个人助理

  • 📝 任务管理和提醒
  • 📊 数据分析
  • 📧 自动回复消息
  • 🔍 网络搜索

# 2. 开发工具

  • 🔧 自动化测试
  • 🐛 代码审查
  • 📖 文档生成
  • 🚀 CI/CD 集成

# 3. 社交媒体

  • 📱 多平台发布
  • 💬 自动回复
  • 📈 数据分析
  • 🔥 舆情监控

# 4. 企业应用

  • 🤝 客户服务机器人
  • 📋 内部流程自动化
  • 📊 业务数据分析
  • 🎯 决策支持系统

# 🛠️ 高级配置

# Docker 沙箱配置

sandbox:
  docker:
    readOnlyRoot: true
    network: "none"
    user: "1000:1000"
    memory: "1g"
    memorySwap: "2g"
    capDrop: ["ALL"]
    pidsLimit: 256

# 多 Agent 协作

models:
  main:
    provider: "openai"
    model: "gpt-4.1"

  subagents:
    - provider: "anthropic"
      model: "claude-3.5"
      capacity: 3
      tasks:
        - code_review
        - testing
        - documentation

# ❓ 常见问题

# Q1: 如何安装 OpenClaw？

参考"安装步骤"章节，推荐使用官方安装脚本。

# Q2: Docker 容器启动失败

问题：Docker 无法启动容器 解决：

# 检查 Docker 服务
sudo systemctl status docker

# 检查镜像
docker images | grep openclaw

# Q3: 消息推送失败

问题：Telegram/WhatsApp 消息不显示 解决：

# 重新配对频道
openclaw pairing approve telegram

# 检查令牌
openclaw config show

# Q4: 内存不足

问题：Agent 崩溃或运行缓慢 解决：

# 增加内存限制
sandbox:
  docker:
    memory: "2g"

# 📈 最新动态 (2026年)

# 重要更新

  • 🔒 安全增强：修复了多个漏洞
  • 🌐 AI 社交网络：AI 助理开始构建自己的社交网络
  • 🚀 性能优化：支持更多并发任务
  • 📱 新平台：支持更多消息渠道

# 版本历史

版本 日期 更新内容
2026.1.29 2月4日 安全补丁
2026.1.29 2月1日 大幅更新
2026.1.28 1月30日 AI 社交功能

# 📚 学习资源

# 官方文档

# 社区资源

# 🤝 贡献指南

# 如何贡献

  1. Fork 项目
  2. 创建特性分支 (git checkout -b feature/AmazingFeature)
  3. 提交更改 (git commit -m 'Add some AmazingFeature')
  4. 推送到分支 (git push origin feature/AmazingFeature)
  5. 开启 Pull Request

# 贡献类型

  • 🐛 Bug 修复
  • ✨ 新功能
  • 📝 文档改进
  • 🎨 UI/UX 优化
  • 🧪 测试改进

# 📝 许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情

# 📧 联系方式

# 🙏 致谢

感谢所有贡献者和支持者：

  • Kian（项目创始人）
  • FreeCodeCamp 教程团队
  • Dev.to 社区
  • 所有 GitHub 贡献者

# ⚠️ 免责声明

本项目仅供学习和研究使用。使用本项目造成的任何后果由使用者自行承担。开发者不对使用本项目的任何损失负责。

最后更新：2026年2月 文档版本：1.0.0 OpenClaw 版本：2026.1.29+

← OpenClaw 安装与飞书集成指南 →