OpenClaw 完整教程：打造你的专属 AI 助手

OpenClaw 是一个开源的个人 AI 助手平台，让 AI 真正成为你的数字伙伴。本文将从零开始，带你完整了解 OpenClaw 的安装、配置、接入和扩展。

---

一、什么是 OpenClaw？

OpenClaw 是一个运行在本地的 AI 助手系统，核心理念是：AI 不只是工具，而是你的数字伙伴。

它不像普通的 AI 聊天工具，它可以：

• 📂 访问本地文件，读写你的工作目录
• 🌐 控制浏览器，自动完成网页操作
• 💬 多渠道接入，支持 Web、Telegram、WhatsApp、Discord、QQ Bot
• 🧠 持久化记忆，跨会话记住你的偏好和上下文
• ⚙️ 调用系统工具，运行代码、管理进程、发送消息
• 🔌 Skills 技能扩展，天气、提醒、健康检查等一键安装

与普通 AI 的区别

功能	普通 AI 聊天	OpenClaw
访问本地文件	❌	✅
控制浏览器	❌	✅
多渠道接入	❌	✅
持久记忆	有限	✅ 文件持久化
技能扩展	❌	✅ Skills 生态
数据隐私	上传云端	✅ 本地运行

---

二、安装 OpenClaw

环境要求

• Node.js 18 或以上版本
• 操作系统：Linux / macOS / Windows（推荐 WSL2）
• npm 或 pnpm 包管理器

安装步骤

第一步：全局安装 OpenClaw

npm install -g openclaw
# 或使用 pnpm
pnpm add -g openclaw

第二步：验证安装

openclaw --version

第三步：初始化工作目录

openclaw init

初始化后会在 ~/.openclaw/ 下生成配置目录，并在当前目录创建 workspace。

---

三、启动 Gateway 服务

Gateway 是 OpenClaw 的核心服务，负责管理 AI 会话、路由消息、调度工具调用。

常用命令

# 启动
openclaw gateway start
# 查看状态
openclaw gateway status
# 重启
openclaw gateway restart
# 停止
openclaw gateway stop
# 安装为系统服务
openclaw gateway install

访问 Web 控制台

启动成功后，打开浏览器访问：

http://127.0.0.1:16002

可以在这里和 AI 对话、查看会话历史、管理配置。

---

四、配置你的 AI 助手

OpenClaw 通过 workspace 目录中的 Markdown 文件定义 AI 的行为。

SOUL.md — AI 的性格定义

# SOUL.md

你是一个干脆、聪明、有点小幽默的 AI 助手。
- 直接给答案，不废话
- 有自己的观点，敢于提出不同意见
- 遇到不确定的事情，先查询再回答

USER.md — 关于用户信息

# USER.md
- Name: 杰哥
- Timezone: Asia/Shanghai
- 偏好: 简洁直接，不废话

MEMORY.md — AI 的长期记忆

AI 会自动更新这个文件，记录重要的决定、偏好和上下文。

HEARTBEAT.md — 心跳任务

# HEARTBEAT.md
- 检查未读邮件，有重要邮件时通知
- 查看今日日历，提前 2 小时提醒会议
- 检查项目 git 状态

---

五、接入消息渠道

5.1 Telegram Bot

1. 向 @BotFather 发送 /newbot 创建机器人，获取 Token

2. 在 openclaw.json 中配置：

   {“channels”: {“telegram”: {“token”: “你的Token”}}}

3. 重启：openclaw gateway restart

4. 找到你的机器人，开始对话！

5.2 QQ Bot

openclaw plugin install qqbot

5.3 Discord

{"channels": {"discord": {"token": "Discord Bot Token"}}}

---

六、Skills 技能扩展

安装技能

openclaw skill install weather        # 天气查询
openclaw skill install coding-agent   # AI 编程助手
openclaw skill install tmux           # 终端控制
openclaw skill install healthcheck    # 安全检查

常用内置技能

weather — 天气查询

"帮我查一下上海今天的天气"

coding-agent — AI 编程助手

"帮我重构这个函数，让它更高效"
"给这个项目添加单元测试"

tmux — 远程终端控制

"查看服务器上 nginx 的运行状态"

qqbot-cron — 智能提醒

"30分钟后提醒我开会"
"每天早上 9 点提醒我看邮件"

---

七、记忆系统详解

记忆分层

memory/
├── 2026-03-01.md    # 每日日志
├── 2026-03-02.md    # 今天
MEMORY.md            # 长期精华记忆

记忆工作流程

1. 每次对话：AI 将重要信息写入当天 memory/YYYY-MM-DD.md
2. 定期整理：通过心跳，AI 回顾日记，提炼内容更新 MEMORY.md
3. 每次启动：AI 读取 MEMORY.md 和最近几天的日记，恢复上下文

手动更新记忆

"记住：我的服务器 IP 是 192.168.1.100"
"把今天讨论的架构决策记录下来"

---

八、浏览器自动化

OpenClaw 支持通过 Playwright 控制浏览器。

安装浏览器

npx playwright install chromium

配置（openclaw.json）

{"browser": {"executablePath": "/path/to/chrome", "noSandbox": true, "headless": true}}

使用示例

"打开 CSDN，搜索 OpenClaw 相关文章"
"帮我截图看一下这个网页现在的样子"
"自动填写这个表单并提交"

---

九、常见问题

Q1：Gateway 启动失败？

openclaw gateway status
cat /tmp/openclaw/openclaw-$(date +%Y-%m-%d).log
openclaw gateway stop && openclaw gateway start

Q2：AI 记不住之前的对话？

ls ~/.openclaw/workspace/memory/
cat ~/.openclaw/workspace/MEMORY.md

Q3：技能安装后不生效？

1. 確认技能文件存在
2. 重启 Gateway：openclaw gateway restart
3. 在对话中明确描述触发条件

Q4：如何切换 AI 模型？

{"model": "anthropic/claude-sonnet-4-6"}

支持 Anthropic、OpenAI、阿里云百炼、火山引擎等。

Q5：如何升级？

npm update -g openclaw && openclaw gateway restart

---

十、总结

OpenClaw 的强大之处在于它的可定制性和本地优先的设计理念：

• 🏠 数据在本地，隐私有保障
• 🧠 记忆持久化，AI 真正了解你
• 🔌 高度可扩展，Skills 生态持续增长
• 📱 多端接入，随时随地使用

从个人助手、到自动化工具、到团队机器人，OpenClaw 都能胜任。

立即开始：

npm install -g openclaw && openclaw init && openclaw gateway start

然后打开 http://127.0.0.1:16002 ，开始你的 AI 助手之旅！

---

📖 官方文档：https://docs.openclaw.ai
💻 GitHub：https://github.com/openclaw/openclaw
💬 社区 Discord：https://discord.com/invite/clawd
🛒 技能市场：https://clawhub.com