AI员工 OpenClaw 零基础部署教程，百度云一键搭建，手机 QQ 随时遥控干活
📌 写在前面
在ChatGPT、Claude等AI服务日益普及的今天，你是否遇到过这样的困扰：
❌ 对话记录被上传到云端，隐私堪忧
❌ 想让AI帮你操作本地文件，却无能为力
❌ 想在不同平台（微信、Telegram、Slack）都能用同一个AI助理
OpenClaw正是为解决这些痛点而生的本地AI助理框架。
参考文章：https://www.hacktwohub.com/
一、OpenClaw是什么？
OpenClaw是一个本地优先的个人AI助理框架，核心特点是：
| 特性 | 说明 |
|---|---|
| 多平台支持 | 支持WhatsApp、Telegram、Slack、Discord、飞书等20+平台 1 |
| 本地运行 | 所有数据存储在本地，隐私可控 |
| 工具调用 | 支持文件操作、网页浏览、代码执行等 |
| 技能扩展 | 通过YAML文件定义新技能，无需修改核心代码 |
| 多模型支持 | 支持OpenAI、Anthropic、Google等主流LLM |
适用场景：
📅 个人日常助理（日程管理、信息检索）
🔄 自动化工作流（邮件处理、报告生成）
💻 开发调试（代码审查、测试辅助）
🔐 隐私敏感场景（本地运行，数据可控）
💡 小贴士：OpenClaw的核心理念是"本地优先"——你的对话记录、文件操作都保存在本地，只有AI推理需要调用云端API。
二、环境准备 🛠️
2.1 系统要求
根据官方文档 2，OpenClaw需要：
Node.js: 版本 22 或更高
操作系统: macOS、Linux、Windows (通过WSL2)
内存建议: 至少 4GB 可用内存
检查Node版本：
node--version # 输出应该 >= v22.0.0
⚠️ 注意：如果你的Node版本过低，可以通过 nvm（Node Version Manager）快速升级：
nvm install 22 nvm use 22
2.2 安装方式
方式一：一键安装脚本（推荐）2
macOS/Linux:
curl-fsSL https://openclaw.ai/install.sh | bash
Windows PowerShell（以管理员身份运行）:
iwr-usebhttps://openclaw.ai/install.ps1|iex
方式二：通过npm安装
npm install -g openclaw@latest # 或使用 pnpm（更快） pnpm add -g openclaw@latest
🔐 安全提示：安装前可以先查看脚本内容，确保安全：
curl-fsSL https://openclaw.ai/install.sh | less
三、快速开始：5分钟上手 🚀
3.1 运行配置向导
安装完成后，运行配置向导 3：
openclaw onboard --install-daemon
💡 参数说明：
--install-daemon会将OpenClaw安装为系统服务，开机自动启动。如果不想安装为服务，可以去掉这个参数。
向导会依次引导你完成：
| 步骤 | 配置项 | 说明 |
|---|---|---|
| 1️⃣ | 模型配置 | 选择AI模型（OpenAI、Claude、Gemini等） |
| 2️⃣ | 工作空间设置 | 默认位置：~/.openclaw/workspace |
| 3️⃣ | Gateway配置 | 端口：18789 |
| 4️⃣ | 消息通道（可选） | Telegram、WhatsApp、飞书等 |
| 5️⃣ | 守护进程安装 | 开机自启动配置 |
📝 配置文件位置：所有配置保存在
~/.openclaw/openclaw.json，后续可手动修改。
3.2 启动Gateway
如果安装了守护进程，Gateway应该已经在运行：
openclaw gateway status
手动启动Gateway：
openclaw gateway --port 18789
3.3 打开控制面板
最简单的测试方式是通过Web界面 4：
openclaw dashboard
浏览器会自动打开http://127.0.0.1:18789/，你可以在WebChat中与AI助理对话。
四、核心概念解析
4.1 架构概览
OpenClaw采用微内核架构，主要由以下组件构成 5：
系统架构
| 层级 | 说明 | 组件 |
|---|---|---|
| 用户界面层 | Web、桌面、移动端 | WebChat / macOS App / CLI / Mobile |
| Gateway控制层 | WebSocket控制平面 | ws://127.0.0.1:18789 |
| 消息通道层 | 多平台消息接入 | WhatsApp / Telegram / Slack / Discord / 飞书... |
| 技能层 | 工具与能力扩展 | 内置技能 / 社区技能 / 自定义技能 |
| 模型层 | AI能力提供 | OpenAI / Anthropic / Google / 本地模型 |
4.2 关键配置文件
配置文件位于~/.openclaw/目录：
| 文件/目录 | 用途 |
|---|---|
openclaw.json | 主配置文件（模型、通道等） |
credentials/ | 存储API密钥和认证信息 |
workspace/ | 工作空间（记忆、技能等） |
最小配置示例6：
{ "agent": { "model": "openai/gpt-4o" } }4.3 会话与记忆
OpenClaw的会话模型 7：
Main Session: 主会话，直接与用户交互
Isolated Session: 隔离会话，用于处理群组消息
Memory: 分为短期记忆（当前会话）和长期记忆（持久化）
五、配置消息通道
5.1 Telegram配置（推荐新手）
Telegram是最容易配置的平台之一：
步骤1：创建机器人
在Telegram中搜索 @BotFather
发送
/newbot命令按提示设置机器人名称
保存返回的Token（格式：
123456789:ABCdefGHIjklMNOpqrsTUVwxyz）
步骤2：配置OpenClaw
编辑配置文件~/.openclaw/openclaw.json：
{ "channels": { "telegram": { "botToken": "你的Bot Token" } } }步骤3：重启Gateway
openclaw gateway restart
步骤4：测试
在Telegram中找到你的机器人，发送任意消息，首次会收到配对请求。
5.2 飞书配置（适合国内用户）
⚠️ 注意：飞书配置相对复杂，需要企业账号或开发者账号。
配置步骤：
登录 飞书开放平台
创建企业自建应用，获取 App ID 和 App Secret
配置权限：
im:message- 接收消息im:message:send_as_bot- 发送消息im:chat- 访问群组信息
设置事件订阅地址（需要公网IP或内网穿透）
💡 替代方案：国内用户也可以使用微信（通过企业微信API）或钉钉，配置方式类似。
5.3 配对机制（安全重要）
默认情况下，OpenClaw使用配对机制保护你的隐私 9：
陌生用户发送消息时，会收到配对码
只有你批准的用户才能与AI助理对话
批准命令：
openclaw pairing approve <sender-id>
六、使用技能扩展功能
6.1 什么是技能？
技能是OpenClaw的扩展机制，通过YAML文件定义工具和能力 10。
6.2 内置技能
OpenClaw内置了多种实用技能：
| 技能 | 功能 |
|---|---|
web_search | 网络搜索（需要Brave API Key） |
web_fetch | 网页内容提取 |
browser | 浏览器控制 |
file | 文件读写操作 |
exec | 命令执行 |
6.3 安装社区技能
从ClawHub安装社区技能 11：
openclaw skill install <skill-name>
6.4 创建自定义技能
在~/.openclaw/workspace/skills/目录创建技能：
# my-skill/SKILL.md --- id: my-custom-skill name: 我的自定义技能 description: 一个简单的示例技能 version: 1.0.0 --- ## 功能说明 这个技能可以帮助用户... ## 使用方法 用户可以说："帮我..."
七、实战示例 💡
7.1 示例1：网络搜索与总结
在WebChat中输入：
帮我搜索一下2024年AI行业最新动态，并总结成3个要点
AI助理响应示例：
根据搜索结果，2024年AI行业的主要动态包括： 1. 多模态模型成为主流 GPT-4V、Gemini Ultra等多模态模型支持图文混合理解 2. 开源模型快速进步 Llama 3、Mistral等开源模型性能接近商业模型 3. AI Agent兴起 自主规划、工具调用的Agent应用开始落地 [来源：各科技媒体综合报道]
7.2 示例2：文件操作与处理
帮我读取 ~/Documents/notes.md 文件内容，并提取其中的待办事项
AI助理会：
调用文件读取工具获取内容
分析并提取所有
TODO或- [ ]格式的待办事项整理成清单返回
7.3 示例3：代码审查
帮我审查当前目录下的 src/main.py 文件，检查潜在的安全问题
AI助理可以：
读取代码文件
分析常见安全漏洞（SQL注入、XSS等）
提供修复建议
7.3 示例3：定时任务
配置定时简报（Cron） 12：
{ "cron": { "jobs": [ { "id": "morning-briefing", "schedule": "0 8 * * *", "action": "agentTurn", "message": "生成今日早间简报" } ] } }八、常见问题
Q1: 如何切换AI模型？
编辑配置文件或使用命令 13：
openclaw configure --section models
Q2: 如何更新OpenClaw？
openclaw update --channel stable
Q3: Gateway无法启动怎么办？
检查端口占用：
lsof -i :18789
运行诊断：
openclaw doctor
Q4: 如何查看日志？
openclaw logs --tail 100
九、进阶资源
官方资源
官网: https://openclaw.ai
文档: https://docs.openclaw.ai
GitHub: https://github.com/openclaw/openclaw
社区: Discord | ClawHub技能市场
学习路径
入门: 完成配置向导，熟悉WebChat界面
进阶: 配置消息通道，实现多平台接入
高级: 编写自定义技能，扩展AI能力
专家: 参与社区贡献，开发新功能
十、总结 🎯
OpenClaw是一个强大且灵活的个人AI助理框架。通过本文的介绍，你应该已经掌握了：
✅ OpenClaw的基本概念和架构
✅ 从安装到配置的完整流程
✅ 消息通道的配置方法
✅ 技能扩展的使用方式
✅ 常见问题的解决方案
📚 学习路径建议
| 阶段 | 时间 | 学习内容 |
|---|---|---|
| 入门 | 1-2天 | 完成基础安装配置 / 熟悉WebChat界面 / 尝试基本对话功能 |
| 进阶 | 1周 | 配置消息通道 / 探索内置技能 / 了解工具调用机制 |
| 高级 | 持续 | 编写自定义技能 / 配置自动化任务 / 参与社区贡献 |
下一步行动：
🚀 完成基础配置后，在WebChat中与AI助理对话
📱 配置一个你最常用的消息通道（如飞书、钉钉）
🔍 探索 ClawHub 上的社区技能
✏️ 根据自己的需求编写第一个自定义技能
最好，一个小彩蛋，一个成熟的AI，应该懂得如何自己写文了~