🦴

OpenClaw AI Agent 完全指南

OpenClaw 是开源 AI 自主编程 Agent，GitHub 2 天内突破 100k Stars。四层架构（Agent / Tool / Channel / Gateway），支持通过 Telegram / WhatsApp 控制电脑，集成 Claude Code 实现 Agent Teams 多智能体协作。

📅 2026-04-12 ⏱️ 20 min read ⭐ 100k+

OpenClaw 代表了 AI 编程的范式转变：从"人问 AI 答"到"人设目标，AI 自主规划执行"。它能像人类一样操作终端、浏览器、文件系统，完成复杂的开发任务。

Table of Contents

OpenClaw 是什么
安装与配置
模型配置
Telegram 接入
Skills 扩展系统
Agent Teams 多智能体协作
Cron 定时任务
Docker 部署
安全配置

OpenClaw 是什么

OpenClaw（曾用名 ClawdBot / MoltBot）是 2026 年最火热的开源 AI Agent 项目，上线 2 天 GitHub Stars 突破 100k，被 Scientific American 和 CNBC 报道。核心特性：

🧠

自主规划执行

设置目标，AI 自动拆解任务、调用工具、验证结果

💬

多平台消息

Telegram / WhatsApp / Discord / Slack 控制电脑

🔗

Claude Code 集成

Agent Teams 多智能体并行协作开发

🛠️

Skills 生态

ClawHub 包管理器，100+ 社区 Skills 扩展

⏰

Cron 调度

定时自动执行任务，结果推送到聊天群

🐳

Docker 一键部署

完整环境打包，一行命令恢复工作环境

四层架构

层级	职责	示例
Agent Layer	AI 大脑，规划和推理	Claude 3.5 / GPT-4
Tool Layer	CLI 工具、浏览器、API	GitHub CLI, chromium
Channel Layer	消息通道接入	Telegram, WhatsApp
Gateway Layer	WebSocket 桥接	ws://127.0.0.1:18789

安装与配置

前置要求

Node.js 22+（必须，Node 18/20 不兼容）
API Key（Anthropic / OpenAI / Google）
Linux / macOS / Windows (WSL2)

安装 OpenClaw

# macOS / Linux
curl -fsSL https://openclaw.ai/install.sh | bash

# Windows (PowerShell)
iwr -useb https://openclaw.ai/install.ps1 | iex

# 或者 npm 全局安装
npm i -g openclaw

验证安装

openclaw --version

# 检查 Gateway 状态
openclaw gateway status

# 打开 Web 控制台
openclaw dashboard
# 访问: http://127.0.0.1:18789/

初始化配置

# 生成默认配置
openclaw setup

# 云服务器设为 local 模式（必须）
openclaw config set gateway.mode local

# 注册 systemd 服务（后台运行）
openclaw daemon install
openclaw daemon start

⚠️

Node.js 版本要求
必须使用 Node.js 22+。检查：node --version。macOS 上用 brew install node@22 && brew link node@22 或 nvm install 22 && nvm use 22。

模型配置

OpenClaw 支持所有 OpenAI 兼容的 API 格式，使用 provider/model 格式（如 anthropic/claude-sonnet-4-5）。

配置 API Key

# Anthropic (Claude)
openclaw models auth paste-token --provider anthropic
# 粘贴你的 API Key

# OpenAI
openclaw models auth paste-token --provider openai

# Google (Gemini)
openclaw models auth paste-token --provider google

设置默认模型

# 查看当前模型
openclaw config get agents.defaults.model.primary

# 设置主模型
openclaw models set "anthropic/claude-opus-4-6"

# 设置备用模型
openclaw config set agents.defaults.model.fallbacks '["openai/gpt-4o"]'

诊断检查

openclaw doctor
# 自动修复常见问题
openclaw doctor --fix

Telegram 接入

通过 Telegram 控制你的电脑，就像发消息一样简单。

创建 Telegram Bot

在 Telegram 搜索 @BotFather
发送 /newbot，设置名称和用户名
复制 Bot Token（格式：123456789:ABCdef...）

配置 OpenClaw

# 设置 Bot Token
openclaw config set channels.telegram.accounts.default.botToken "YOUR_BOT_TOKEN"

# 启用 Telegram 插件
openclaw config set plugins.entries.telegram.enabled true

# 重启 Gateway
openclaw daemon restart

# 查看待配对设备
openclaw pairing list telegram

# 审批配对
openclaw pairing approve telegram <PAIRING_CODE>

✅

配置完成！
给你的 Telegram Bot 发一条消息，OpenClaw 会自动回复并开始监听指令。

Skills 扩展系统

Skills 是 OpenClaw 的核心扩展机制，通过 ClawHub 包管理器安装。

安装系统工具

# 浏览器自动化
sudo apt install -y chromium-browser

# GitHub CLI
sudo apt install -y gh

# Claude Code
npm i -g @anthropic-ai/claude-code

# Gemini CLI
npm i -g @google/gemini-cli

# YouTube 下载
pip3 install yt-dlp

# 音视频处理
sudo apt install -y ffmpeg ripgrep

安装社区 Skills

# 搜索 Skills
npx clawhub search summarize

# 安装热门 Skills
npx clawhub install sag              # ElevenLabs TTS 语音合成
npx clawhub install nano-pdf       # PDF 处理
npx clawhub install summarize       # 文章摘要
npx clawhub install blogwatcher    # 博客监控
npx clawhub install twit            # Twitter/X 操作

创建自定义 Skill

创建 ~/.openclaw/workspace/skills/my-skill/SKILL.md：

---
name: my-skill
description: My custom AI tool
metadata: {
  "openclaw": {
    "emoji": "🔧",
    "requires": {
      "bins": ["curl"],
      "env": ["MY_API_KEY"]
    }
  }
}
---

# My Custom Skill

This skill does something useful.

## Usage

Simply tell OpenClaw what you need, and it will use this skill automatically.

## Environment Variables

Set `MY_API_KEY` in your environment or systemd service file.

设置 Skills API Keys

# 写入 /etc/systemd/system/openclaw.service 的 Environment= 行
sudo nano /etc/systemd/system/openclaw.service

# 添加:
# Environment=OPENAI_API_KEY=sk-xxx
# Environment=GEMINI_API_KEY=xxx

sudo systemctl daemon-reload
sudo systemctl restart openclaw

Agent Teams 多智能体协作

OpenClaw 的杀手级功能：多智能体并行协作。一个任务可以拆分给多个 Agent 同时处理。

创建 Agent Team

# 创建一个前端+后端的开发团队
openclaw team create my-project \
  --agents "frontend:claude-sonnet-4-5,backend:claude-opus-4-6" \
  --task "Build a REST API with React frontend"

# 查看团队状态
openclaw team status my-project

Hook 回调机制

Hook 可以在任务完成时自动触发通知：

# .openclaw/hooks.yml
on_task_complete:
  - action: telegram_notify
    message: "✅ Task {{task_id}} completed: {{result}}"
  - action: webhook
    url: "https://your-webhook.com/notify"
    body: '{"task": "{{task_id}}", "status": "done"}'

on_task_failed:
  - action: telegram_notify
    message: "❌ Task {{task_id}} failed: {{error}}"

💡

典型 Agent Teams 流程
1. 手机发送开发指令 → OpenClaw 接收
2. Claude Code Agent Teams 自动拆分任务
3. 多个 Agent 并行开发不同模块
4. 任务完成 → Stop Hook 触发 → 自动推送详细报告到聊天群

Cron 定时任务

OpenClaw 支持定时自动执行任务并推送结果。

配置 Cron

# 每天早上 9 点自动执行 AI 新闻简报
openclaw cron create \
  --name "Daily AI News" \
  --schedule "0 9 * * *" \
  --prompt "Search for the top 5 AI/ML news from yesterday. Format as a bullet-point report." \
  --deliver "telegram" \
  --model "anthropic/claude-sonnet-4-5"

结合 BlogWatcher Skill

设置每日 AI 新闻简报：

# OpenClaw 委托任务 -> Claude Code 独立运行
# -> 任务完成触发 Stop Hook -> 写入结果 -> 唤醒 OpenClaw -> 推送通知到聊天群

openclaw cron create \
  --name "Morning Dev Brief" \
  --schedule "0 8 * * 1-5" \
  --skill "blogwatcher" \
  --prompt "Monitor AI news feeds for developer tools updates from the past 24 hours. Summarize top 3 findings."

管理 Cron

openclaw cron list
openclaw cron pause <job_id>
openclaw cron resume <job_id>
openclaw cron remove <job_id>

Docker 部署

OpenClaw 提供 Docker 镜像，一行命令恢复完整工作环境。

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

# 运行（需要绑定 Docker Socket）
docker run -d \
  --name openclaw \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v ~/.openclaw:/app/.openclaw \
  -p 18789:18789 \
  -e OPENCLAW_API_KEY=sk-ant-xxxxx \
  --restart unless-stopped \
  openclaw/openclaw:latest

# 访问 Web Dashboard
openclaw dashboard

💡

Docker 方式优势
包含所有系统依赖、NPM 全局包、CLI 工具、自定义 Skills 和 Hook 脚本。一条命令即可在全新机器上恢复完整开发环境。

安全配置

⚠️

安全警告
OpenClaw 可以执行任意命令，请务必配置 API 密钥保护，并通过 admin_ids 或 pairing 限制访问权限。

安全检查清单

✅ 始终启用 Telegram pairing（配对码审批）
✅ 设置 channels.telegram.allowed_user_ids
✅ API Key 写入 systemd Environment，不写在配置文件
✅ 定期检查 openclaw logs 中的异常命令
✅ 使用 openclaw config set agents.sandbox.enabled true 启用沙箱

OpenClaw 是什么

四层架构

安装与配置

前置要求

安装 OpenClaw

验证安装

初始化配置

模型配置

配置 API Key

设置默认模型

诊断检查

Telegram 接入

创建 Telegram Bot

配置 OpenClaw

Skills 扩展系统

安装系统工具

安装社区 Skills

创建自定义 Skill

设置 Skills API Keys

Agent Teams 多智能体协作

创建 Agent Team

Hook 回调机制

Cron 定时任务

配置 Cron

结合 BlogWatcher Skill

管理 Cron

Docker 部署

安全配置

安全检查清单

相关教程