OpenClaw 不是新的 AI 模型,不和 Claude、GPT 竞争——它是让这些模型"长出手脚"的软件。它给 AI 连接你的文件、终端、浏览器、消息应用,让对话有记忆,能定时自主行动。
截止 2026 年 2 月,OpenClaw 在 GitHub 获得 200,000+ Stars,成为开源历史上增长最快的项目之一。
一句话理解 OpenClaw
- ChatGPT / Claude.ai:大脑在瓶子里,每次对话从零开始
- OpenClaw:把同一个大脑插进你的电脑,连上文件、终端、消息软件,还有记忆
五个比喻理解核心概念
| 比喻 | OpenClaw 组件 | 作用 |
|---|---|---|
| 鱼缸(Tank) | 你的电脑 / VPS | OpenClaw 运行的地方,本地托管 |
| 食物(Food) | LLM API Key | Agent 的"大脑"来源(Claude/GPT/Ollama) |
| 规则(Rules) | SOUL.md | 行为指南,每次启动自动读取 |
| 记忆(Memory) | memory/ 文件夹 | 每日日记 + 长期记忆 MEMORY.md |
| 技能(Skills) | SKILL.md 文件 | 特定任务的专属指南 |
| 心跳(Heartbeat) | HEARTBEAT.md | 30 分钟周期,主动检查需要做什么 |
安装步骤
前提条件
- Node.js 22+(
node --version确认) - macOS / Linux / Windows(Windows 推荐 WSL2)
- LLM API Key(Anthropic Claude、OpenAI GPT,或 Ollama 本地模型免费)
第一步:安装 OpenClaw
npm install -g openclaw@latest如果遇到权限问题(macOS/Linux):
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:<existing-PATH>' >> ~/.bashrc
source ~/.bashrc
npm install -g openclaw@latest第二步:运行安装向导
openclaw onboard --install-daemon向导会依次问:
- 安全确认:读并接受(Agent 有访问本地文件系统的权限)
- 快速开始 vs 自定义:第一次选快速开始
- 模型选择:有 Anthropic API Key 选 Claude,有 OpenAI Key 选 GPT,没有 Key 选 Ollama(本地免费)
- 渠道配置:第一次只选一个平台,推荐 Telegram(配置最简单)
- 技能:先跳过,之后再加
- 界面:选 Web UI,方便看发生了什么
第三步:启动 Gateway
openclaw gateway start
# 确认状态
openclaw gateway status
# 打开 Dashboard(浏览器查看)
openclaw dashboard
# 访问 http://127.0.0.1:18789配置 Telegram(推荐第一个渠道)
创建 Bot
- 在 Telegram 搜索 @BotFather
- 发
/newbot - 给 Bot 取名(例:MyLobster)
- 给 Bot 取用户名(必须以
_bot结尾,例:my_lobster_bot) - 保存 BotFather 返回的 API Token
获取你的 Telegram User ID
在 Telegram 搜索 @userinfobot,发 /start,它会返回你的 User ID(数字)。
配置 OpenClaw
编辑 ~/.openclaw/openclaw.json:
{
"channels": {
"telegram": {
"enabled": true,
"token": "1234567890:你的BOT_TOKEN",
"allowFrom": ["你的Telegram_User_ID"]
}
}
}allowFrom 非常重要——只允许白名单里的用户控制你的 Agent。
openclaw gateway restart打开 Telegram,给你的 Bot 发消息,它应该会回复了。
工作区文件:理解灵魂所在
ls ~/.openclaw/workspace/主要文件:
| 文件 | 作用 |
|---|---|
SOUL.md | 核心配置,定义 Agent 的性格、行为规则、工作方式 |
USER.md | 关于你的信息,帮助 Agent 更好地服务你 |
MEMORY.md | 长期记忆,重要信息的精华摘要 |
AGENTS.md | 工作区使用指南(Agent 每次会话都会读) |
HEARTBEAT.md | 定时检查任务(留空则不执行,可以加待办事项) |
memory/ | 每日日志目录(2026-04-18.md 格式) |
配置 SOUL.md:定义 Agent 性格
SOUL.md 是最重要的文件。每次 Agent 启动都会读它,决定 Agent 怎么思考和行动。
示例 SOUL.md:
# 我是谁
你是 Alex,一个高效的个人 AI 助理。
你的主要工作是帮助我处理代码、管理日程、整理信息。
## 工作方式
- 直接、简洁地回答
- 不要重复我说的话
- 代码用代码块展示
- 遇到不确定的事情,先问清楚再行动
## 能力范围
可以自主做的:读文件、搜索网络、分析数据、写文档
需要先问我的:删除文件、发送消息到外部、任何不可逆操作
## 记忆习惯
重要的决定和新信息,主动存到 memory/ 目录。
长期有价值的信息整理到 MEMORY.md。记忆系统:让 Agent 跨会话记住你
OpenClaw 的记忆分三层:
层 1:会话上下文(当前对话)
自动维护,结束会话后消失。
层 2:每日日志(memory/YYYY-MM-DD.md)
Agent 在对话中自动写入重要信息:
# 2026-04-18
## 今日完成
- 修复了支付模块的 race condition 问题(ticket #456)
- 确认了 PostgreSQL 迁移窗口:4月20日凌晨2点
## 记录
- 用户的数据库是 PostgreSQL 15,不是 Postgres 16
- CI 流水线用 GitHub Actions,不是 Jenkins(已迁移)层 3:长期记忆(MEMORY.md)
精华提炼,跨时间的重要信息:
# 长期记忆
## 技术环境
- 主项目:~/work/myproject(Go 1.25 + Vue 3 + PostgreSQL 15)
- 用 pnpm 不用 npm(这个项目特殊)
- CI:GitHub Actions,部署 script 在 scripts/deploy.sh
## 个人偏好
- 代码风格:函数式 > 面向对象,TypeScript 严格模式
- 不喜欢冗长解释,直接给答案
- 周报格式:Markdown 三段(本周完成/下周计划/风险)手动更新记忆:
记住:我们的 API 限速是每分钟 100 次请求
把这个加到你的长期记忆:公司内网地址是 10.0.1.0/24
心跳系统:让 Agent 主动工作
默认每 30 分钟,Agent 醒来检查 HEARTBEAT.md,看有没有需要做的事。
HEARTBEAT.md 示例:
# 心跳检查清单
## 每次检查
- [ ] 检查 GitHub 有没有 @ 我的 Issue 或 PR 评论
- [ ] 如果有新的 Dependabot PR,评估是否安全合并
## 每天一次(早上 8 点后第一次心跳)
- [ ] 检查今天的日历事件(向我汇报)
- [ ] 检查过去 24 小时的 git log 有没有异常
## 有重要事项时立即通知
- GitHub 上有 Critical 标签的 Issue
- CI 失败超过 2 次没有任务时 Agent 回复 HEARTBEAT_OK 保持静默,不打扰你。
安装 Skills:扩展 Agent 能力
技能是 SKILL.md 文件,给 Agent 提供特定任务的专属指南。
# 从 clawhub.ai 安装技能
openclaw skills install weather
openclaw skills install github-management
openclaw skills install obsidian-notes
# 查看已安装技能
openclaw skills list或者自己创建 ~/.openclaw/workspace-content/skills/my-skill/SKILL.md:
# MY-SKILL
## 触发条件
当用户让我整理日报时使用此技能。
## 执行步骤
1. 读取 ~/notes/today.md 里的今日记录
2. 按"完成/进行中/明日计划"分类整理
3. 生成不超过 10 条要点
4. 保存到 ~/notes/reports/YYYY-MM-DD.md多渠道配置(进阶)
配置多个消息平台,Agent 在所有平台同时在线:
{
"channels": {
"telegram": {
"enabled": true,
"token": "your-telegram-token",
"allowFrom": ["your-telegram-id"]
},
"discord": {
"enabled": true,
"token": "your-discord-bot-token",
"guildId": "your-server-id"
}
}
}安全建议
allowFrom必须配置:不配置则任何人发消息都能控制你的 Agent- 不要在
openclaw.json里存真实密码:用环境变量或.env文件 - 沙箱模式(进阶):在 Docker 里运行 Agent,限制危险命令的影响范围
- 定期检查 Agent 日志:
openclaw logs -f查看 Agent 在做什么
常见问题
Agent 不回复消息:检查 openclaw gateway status,确认 Gateway 在运行
回复很慢:正常,Claude/GPT API 响应时间 2-10 秒。复杂任务更长
找不到工作区文件:默认在 ~/.openclaw/workspace/,也可以 openclaw workspace --path 查看
更新 OpenClaw:
npm update -g openclaw
openclaw --version # 确认版本来源:pub.towardsai.net OpenClaw 零基础指南 | docs.openclaw.ai 官方文档 | 整理:ClaudeEagle