一、OpenClaw 是什么？为什么它能火遍开源圈？
 

OpenClaw（绰号“小龙虾”） 是 2026 年现象级开源 AI 智能体（AI Agent）框架，GitHub 星标超 30万，主打 本地优先、隐私可控、任务执行、多渠道接入，彻底解决传统大模型“只会说不会做”的痛点。
 
 
- 核心定位：不是聊天机器人，是能干活的 AI 员工/私人助理——理解自然语言 → 拆解任务 → 调用工具 → 操作系统/文件/浏览器 → 完成真实工作 。
​
- 与 ChatGPT 本质区别：
​
- ChatGPT：被动问答、内容生成、云端数据、无法操作本地文件
​
- OpenClaw：主动执行、本地部署、数据全私有、系统级操作、多IM接入

​
- 核心优势（必记）

​1. 🏠 本地优先：引擎/数据/日志全在你设备，敏感数据不上云
​
2. 🔌 强执行能力：文件读写、Shell 命令、浏览器自动化、API 调用、任务编排
​
3. 🧩 技能扩展：13000+ 社区 Skills（插件），能力无限扩展
​
4. 💬 全渠道接入：飞书、企微、QQ、Telegram、Discord、WhatsApp 等 20+ 平台
​
5. 🔐 安全可控：细粒度权限、操作审批、DM 配对、白名单机制
​
6. 🆓 完全开源：MIT 协议，免费商用，无隐藏付费

 
二、核心架构与技术原理（深度解析）

 
OpenClaw 采用 Gateway + Agent + Skills + Memory 四大模块化架构，像“龙虾”的身体、大脑、爪子、记忆系统：
 
 

1. 四大核心组件

 
- Gateway（网关）：入口中枢
负责多渠道消息路由、会话管理、权限校验、安全隔离，是用户与 AI 交互的唯一入口 。
​
- Agent（智能体大脑）：决策核心
对接 LLM（GPT-4o/Claude/通义千问/Ollama 本地模型），做意图解析、任务规划、逻辑推理、步骤编排。
​
- Skills（技能/爪子）：执行单元
插件化工具集，内置 65+ 基础技能（文件、浏览器、搜索、定时、代码）+ 社区 13000+ 扩展技能。

 
​
- Memory（记忆系统）：四层记忆
​
- SOUL：长期人格与偏好
​
- TOOLS：工具使用历史
​
- USER：用户习惯与数据
​
- Session：短期对话上下文

 
2. 执行流程：Observe - Think - Act - Check

 
1. Observe（观察）：接收指令 → 解析意图 → 读取上下文
​
2. Think（思考）：LLM 拆解任务 → 规划步骤 → 选择技能
​
3. Act（执行）：调用工具 → 操作系统/网络 → 完成动作
​
4. Check（检查）：结果校验 → 异常处理 → 反馈用户 → 自主重试

 
三、保姆级安装部署（3 种方案，新手首选）
 

环境准备
 
- 系统：Windows/macOS/Linux 全支持
​
- 必备：Node.js ≥ 22、npm/pnpm、Git
​
- 可选：Docker（生产部署）、Ollama（本地模型）

 
方案 1：一键脚本（新手首选，5 分钟搞定）

 
- Windows（管理员 PowerShell）
# 官方

iwr -useb https://openclaw.ai/install.ps1 | iex

# 国内加速（推荐）

iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex

- macOS/Linux

# 官方

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

# 国内加速

curl -fsSL https://open-claw.org.cn/install-cn.sh | bash 

方案 2：npm 安装（开发者）

# 全局安装

npm install -g openclaw@latest

# 初始化配置（引导式）

openclaw onboard --install-daemon

# 启动网关

openclaw gateway --port 18789 --verbose

方案 3：Docker 部署（生产/稳定）

# 克隆

git clone https://github.com/openclaw/openclaw.git
cd openclaw

# 后台启动

docker-compose up -d

# 查看日志

docker-compose logs -f

 

 
四、核心配置：API 与渠道接入（关键步骤）
 

1. 配置 AI 模型（LLM）
 

核心文件： ~/.openclaw/agents/main/auth-profiles.json 

{
  "profiles": [
    {
      "id": "claude-main",
      "type": "api-key",
      "provider": "anthropic",
      "apiKey": "sk-ant-xxx",
      "model": "claude-sonnet-4-6"
    },
    {
      "id": "qwen-local",
      "type": "api-key",
      "provider": "siliconflow",
      "apiKey": "sk-xxx",
      "model": "Qwen2-72B-Instruct"
    }
  ]
}

- 支持：OpenAI、Anthropic、通义千问、硅基流动、Ollama 本地模型等
 

2. 接入 IM 渠道（以飞书/企微为例）
 

1. 进入对应平台开放平台，创建机器人/应用
​
2. 获取 Bot Token、App ID、Secret
​
3. 执行  openclaw channel add  选择渠道，填入凭证
​
4. 重启网关： openclaw restart 

 
五、基础使用：让 AI 帮你干活（实战指令）
 

1. 命令行基础
 

# 发送测试消息

openclaw message send --to @user --message "你好"

# AI 对话

openclaw agent --message "整理桌面所有 PDF 文件"

# 查看技能

openclaw skill list

# 安装技能

openclaw skill install browser

 
 2. 真实场景示例（直接复制用）
 

- 文件管理"把 Downloads 里大于 100MB 的视频移到 D 盘视频文件夹"
​
- 浏览器自动化"打开 Chrome，搜索 2026 AI 趋势，保存前 5 页为 PDF"
​
- 办公自动化"读取桌面 周报.docx，总结要点，发飞书给同事"
​
- 开发辅助"检查当前项目代码漏洞，生成修复建议"

 
六、技能（Skills）系统：扩展 AI 能力
 

- 三层优先级

​
1. Workspace：项目专属技能
​
2. User：个人全局技能
​
3. Bundled：官方内置技能

​
- 常用内置技能

​
-  file ：文件读写、搜索、批量重命名
​
-  browser ：网页浏览、截图、数据抓取
​
-  cron ：定时任务（每日报表、定时提醒）
​
-  code ：代码执行、审查、生成
​
-  search ：联网搜索、学术/新闻检索

 
七、安全与避坑指南（必看）

 
1. 安全警告：只装官方  openclaw  包，警惕  @openclaw-ai  等恶意 npm 包
​
2. 权限最小化：仅开放必要技能，敏感操作（删文件、Shell）开启审批
​
3. API Key 保密：不要上传配置文件到 GitHub，使用环境变量
​
4. 国内网络：模型 API 可能超时，用国内代理或硅基流动等国内服务商
​
5. 常见问题
​
- 安装失败：检查 Node.js 版本 ≥22，清理 npm 缓存
​
- 渠道连不上：核对 Token/ID，防火墙放行 18789 端口
​
- AI 不执行：确认技能已安装，日志排查  openclaw logs 

 
八、总结与进阶

 
OpenClaw 不是玩具，是真正能提升 10 倍效率的本地 AI 助理——隐私可控、免费开源、能力无限扩展。从个人文件整理、办公自动化，到开发辅助、企业私有部署，全场景覆盖。
 
下一步：按本文部署 → 接入常用 IM → 尝试 3 个日常任务 → 安装社区技能 → 打造专属 AI 员工！