夜雨聆风
OpenClaw 从认识它到 5 分钟跑通第一个对话
本节目标:用一篇文章把 OpenClaw 的来龙去脉、设计哲学、安装步骤、第一次 onboard、第一条对话、第一个 Cron、五个最容易踩的坑、五条不能碰的红线全部讲清楚。读完你能用一个下午做出”我在地铁上发微信、家里电脑帮我跑代码、晚上 11 点它准时催我喝水睡觉”这种事——而且能用自己的话把 OpenClaw 是什么讲给一个完全不懂技术的朋友听。
一、先讲两个真实场景
场景 1:你出门了,代码忘 push 了
你周末出去玩,在地铁上突然想起来——昨晚改的代码忘 push 了。
打开手机你才意识到:得先连 VPN、打开终端 App、敲 git push、还要输密码。三分钟过去了,你已经过了红绿灯。
痛点 1:你在外面,但你的电脑是关着的——云端 ChatGPT 帮不了你,因为它压根接触不到你那台机器。
场景 2:凌晨 1 点,你还没写周报
凌晨 1 点,你正在床上刷手机,突然想起来:明天早上 9 点要给老板发的周报还没写。
打开微信电脑版?太亮了,会吵醒旁边的人。打开 ChatGPT 网页?它不知道你这周干了啥,得你打字告诉它。让 Siri 打开备忘录?Siri 不会写。
如果你电脑里有一只 OpenClaw:
你: (在微信里发)帮我看看本周 git 提交,生成周报Molty: (30 秒后回) 🦞 已扫描你 ~/projects 下所有仓库,本周共 23 次提交。 【本周周报】 ## 主要进展 1. 完成了 XX 模块重构(8 次提交) 2. 修复了 3 个生产环境 Bug 3. 配合产品对接了支付接口 ## 下周计划 4. 上线 XX 模块 5. ... 要直接发到企业微信发给老板吗?你: 发Molty: 🦞 已通过 wecom-work 渠道发送给"老板"。整个过程你没起床、没打开电脑、没敲过一个字超过 10 个字。
接下来还有两个小痛点
痛点 2:云端 AI 只能输出文字,不能动手——你妈让你帮她整理三年的家庭照片,ChatGPT 只能写一个 Python 脚本给你,然后你得自己去你妈电脑上装 Python、跑、调 bug。
痛点 3:云端 AI 是被动的,你不问它就死了——你想让 Claude 每天早上自动给你一份昨日科技新闻摘要?它不会主动找你,你得每天打开它问。坚持三天就放弃了。
痛点 4:你的私密数据,云端 AI 总是要”过手”——你想让 AI 看一份公司内部文档,但又怕被传到云上。结果要么不用,要么粘贴上去心里咯噔一下。
OpenClaw 就是来一次性解决这四件事的。
┌──────────────────────────────────────────────────────┐│ ││ 云端 ChatGPT 的"我不能": ││ ││ ❌ 接触不到你电脑 ││ ❌ 只会输出文字 ││ ❌ 不会主动找你 ││ ❌ 数据要"过手"云上 ││ ││ OpenClaw 的"我可以": ││ ││ ✅ 住在你电脑里 ││ ✅ 能跑命令、读文件、调 API ││ ✅ 可以定时主动找你 ││ ✅ 数据全在本地,你说算就算 ││ │└──────────────────────────────────────────────────────┘OpenClaw 想让你过的日子是:AI 不再是一个你要主动打开的工具,而是一个长期住在你电脑里、随叫随到的助手。
二、一句话定义 OpenClaw
OpenClaw 是一个开源、自托管、跨渠道的个人 AI Agent 平台——你把它装在自己电脑上,通过你已经在用的聊天软件(微信 / WhatsApp / 飞书 / Slack…)和它对话,它能帮你读文件、跑命令、调 API、定时干活。
把这一句话拆开看:
|
|
|
|
|---|---|---|
| 开源 |
|
|
| 自托管 |
|
|
| 跨渠道 |
|
|
| 个人 AI Agent |
|
|
| 平台 |
|
|
三、太空龙虾🦞 比喻彻底搞懂 OpenClaw
OpenClaw 官方吉祥物叫 Molty,是一只太空龙虾。这不是吉祥物组随便选的——龙虾这个比喻能精准对应它的设计:
┌─────────────────────────┐ │ 一只太空龙虾🦞 │ │ │ │ ┌─────┐ │ │ │脑子 │ ←─ Workspace │ │ │ 工作空间 │ └─────┘ │ │ ╱ │ ╲ │ │ 爪 1 爪 2 爪 N ←─ Skills │ 开瓶 抓鱼 剪指甲 │ │ │ │ 嘴 耳 │ │ ↑ ↑ │ │ Channel Channel │ │ (微信) (Slack) │ │ │ │ 全身泡在 水族箱 = Gateway │ 水族箱里 ← 网关 │ └─────────────────────────┘理解 OpenClaw,就把它当成你养的一只小龙虾宠物:
|
|
|
|---|---|
|
|
Gateway(网关)
|
|
|
Workspace(工作空间)
|
|
|
Channel(渠道)
|
|
|
Skill(技能)
|
|
|
Sandbox(沙箱)
|
整个流程一句话:你在聊天软件里说话 → 网关收到 → 工作空间里的”脑子”决定调哪个技能 → 在沙箱里执行 → 把结果通过同一个聊天软件回给你。
┌─────────────────────────────┐ │ 你的电脑 │ │ │ │ ┌─────────────────────┐ │你 ─微信────→ │ │ Gateway 网关 │ │你 ─Slack───→ │ │ ↓ │ │你 ─WhatsApp→ │ │ Workspace │ │ │ │ ↓ │ │ │ │ Skills 技能树 │ │ │ │ ↓ │ │ │ │ Sandbox 沙箱 │ │ │ │ ↓ │ │ │ │ 实际操作(读文件、跑命令)│ │ │ └─────────────────────┘ │ └─────────────────────────────┘下面把每个比喻挨个挖深。
3.1 水族箱 = Gateway(网关)
龙虾不能离开水。Gateway 是 OpenClaw 的核心进程,跑在你电脑上,负责:
-
• 接收所有渠道(微信、Telegram…)发来的消息 -
• 路由消息到合适的 Workspace -
• 维护和外界的 RPC 连接 -
• 管理 Cron 定时任务 -
• 沙箱隔离
openclaw onboard --install-daemon 这条命令,就是把网关装成开机自启服务,让水族箱永远不断电。
类比:相当于 Docker 的 daemon,或者 macOS 的 launchd。它默默跑在后台,你看不见但它一直在工作。
3.2 脑子 = Workspace(工作空间)
龙虾的脑子决定它怎么思考。Workspace 是一组配置 + 模型 + 上下文 + 提示词的集合。
你可以养多只龙虾,每只脑子不一样:
|
|
|
|
|---|---|---|
personal |
|
|
coder |
|
|
family |
|
|
secret |
|
|
每只龙虾有独立记忆、独立技能、独立配置,互相不串味。
3.3 嘴和耳 = Channel(渠道)
龙虾通过嘴说话、耳朵听话。Channel 是渠道适配器,把不同聊天软件的协议统一成 OpenClaw 能懂的格式。
OpenClaw 内置 20+ 渠道:
国际: Telegram、WhatsApp、Discord、Slack、Signal、iMessage、 Matrix、Teams、Twitch、IRC...国内: 微信、QQ、钉钉、企业微信、飞书、LINE、Zalo...特殊: WebChat (网页)、Email、Webhook (任何能发 HTTP 的工具)一只龙虾可以同时连多个渠道——你在微信问它,它在微信回;你在飞书@它,它在飞书答。会话默认是不串的。
3.4 爪子 = Skill(技能)
龙虾每个爪子能干一件事。Skill 是 Agent 真正”动手”的能力单元。
OpenClaw 内置 100+ Skills,常用的几类:
┌───────────┬────────────────────────────────────┐│ Shell │ 跑 Bash 命令 ││ Filesystem │ 读/写/移动文件 ││ Web │ 浏览网页、爬数据 ││ HTTP │ 调任意 API ││ Cron │ 定时任务 ││ Discord │ 操作 Discord 服务器 ││ GitHub │ 创建 Issue / PR / Comment ││ Email │ 收发邮件 ││ Calendar │ 日历操作 ││ Clipboard │ 读写剪贴板 ││ Screenshot│ 截屏 ││ ... │ 还有很多 │└───────────┴────────────────────────────────────┘而且你可以自己写新爪子——这是 OpenClaw 的核心扩展点。
3.5 试衣间 = Sandbox(沙箱)
龙虾的爪子很硬,乱抓东西能划坏家具。Sandbox 是技能执行前的隔离环境,确保 Agent 跑命令不会直接动你主系统。
三种沙箱:
|
|
|
|
|---|---|---|
docker |
|
|
ssh |
|
|
openshell |
|
|
强烈建议生产用 docker,开发可以用 openshell,千万别选
none(裸跑)。
四、它和别的工具是什么关系
4.1 和 ChatGPT / Claude.ai 的区别
┌─────────────────────┬─────────────────────┐│ ChatGPT/Claude.ai │ OpenClaw │├─────────────────────┼─────────────────────┤│ 云端服务 │ 跑你电脑上 ││ 浏览器/App 入口 │ 你常用的聊天软件 ││ 只能聊 │ 能动手干活 ││ 你必须主动打开 │ 它能主动找你 ││ 数据上云 │ 数据本地 ││ 开箱即用 │ 要自己装 │└─────────────────────┴─────────────────────┘4.2 和 n8n / Dify / Coze 的区别
n8n / Dify / Coze 是工作流编排平台——你用拖拽 UI 画”收到邮件 → 调 GPT → 发钉钉”这种流程图。
OpenClaw 不是这个定位:
n8n / Dify / Coze: 你画一个固定流程,触发条件满足时按图执行 适合:重复性高、流程固定的任务OpenClaw: Agent 自己根据你说的话决定调哪些 Skill、按什么顺序 适合:需要灵活理解意图、动态决策的任务两者可以组合——OpenClaw 当”嘴”,n8n 当”工作流引擎”,由 OpenClaw 触发 n8n 的 webhook。
4.3 和”AI 编程工具”(Claude Code、Cursor)的区别
这是最容易混淆的——名字都带”Claude/Claw”,定位却完全不同。
OpenClaw 不专注代码,它是通用助理——代码只是它能做的事之一。如果你只想要”AI 帮我写代码”,Claude Code / Cursor 更合适;如果你想要”AI 帮我管理生活 + 偶尔写写代码”,OpenClaw 更合适。
|
|
|
|
|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
它们解决的问题不一样,完全可以同时存在:Claude Code 帮你写代码,OpenClaw 帮你管邮件、推送、文件、提醒。
五、OpenClaw 不是什么——三个常见误会
误会 1:”OpenClaw 是聊天机器人套壳”
❌ 错。
聊天机器人套壳 = 套个皮、转发给 ChatGPT、再转发回来。
OpenClaw 完全不一样:
聊天机器人套壳: 你 → bot → 调 ChatGPT API → ChatGPT 输出文字 → bot 转给你OpenClaw: 你 → 网关 → Workspace 决策 → ↓ (要查文件 → 调 filesystem skill) (要跑命令 → 调 shell skill,在沙箱里跑) (要查邮件 → 调 gmail skill) ↓ 网关把多步执行结果合成回复 → 回给你它真的在你电脑上做事,不只是转发文字。
误会 2:”OpenClaw 等于本地版 Claude Code”
❌ 错。
虽然名字像,但定位差很多——见上一节那张表。它们解决的问题不一样,可以共存。
误会 3:”OpenClaw 是 SaaS 服务,要付月费”
❌ 错。
OpenClaw 本身完全免费、开源、MIT 协议。你付费的是:
-
• 你接的 LLM API(DeepSeek / Claude / OpenAI / Kimi 的 token 费) -
• 服务器(如果你不用自己电脑)
如果你接本地模型(Ollama / Llama),理论上全程零成本。
六、谁该用、谁不该用
✅ 适合的场景
-
• 你已经习惯用微信 / Slack / Telegram 做日常沟通 -
• 你有一台不太忙的电脑或服务器 -
• 你想让 AI 真的帮你”动手”,不只是聊天 -
• 你介意数据上云,或者必须本地处理敏感信息 -
• 你愿意花一两个下午折腾配置(不是开箱即用级别)
❌ 不适合的场景
-
• 你不想装任何东西,只想”打开网页就用”——用 ChatGPT -
• 你只关心 AI 写代码——用 Claude Code 或 Cursor -
• 你想给非技术朋友/家人一键安装——OpenClaw 当前的安装/调试有门槛,不太友好 -
• 你需要企业级 SSO / 审计 / 合规——OpenClaw 是个人向,企业能力薄弱
七、典型使用场景一览
把”它能干什么”画一张地图,帮你建立直觉:
┌──────────────────────────────────────────────────────┐│ OpenClaw 典型使用场景 ││ ││ 日常生活 ││ ├── 整理文件 / 照片 / 下载 ││ ├── 提醒喝水 / 吃药 / 起床 ││ ├── 收拾日历 / 邮件 / 待办 ││ └── 早晚天气推送 ││ ││ 工作辅助 ││ ├── 周报 / 日报自动生成 ││ ├── 会议纪要整理 ││ ├── 邮件分类与自动回复 ││ └── PR / Issue 状态推送 ││ ││ 开发工作 ││ ├── Git 操作(commit / push / 看历史) ││ ├── 远程跑测试 / 部署 ││ ├── 服务器健康监控 ││ └── 错误日志告警 ││ ││ 内容创作 ││ ├── 选题脑暴 ││ ├── 资料检索与整合 ││ ├── 多平台发布 ││ └── 数据看板 ││ ││ 家庭自动化 ││ ├── 智能灯 / 空调 / 窗帘 ││ ├── 安防摄像头检查 ││ ├── 家庭日历共享 ││ └── 给爸妈推送养生提醒 ││ │└──────────────────────────────────────────────────────┘挑你最有共鸣的一个,跟着下面的教程走,你今天下午就能做出来。
八、动手前,先准备这三样东西
8.1 一台”它搞砸了你也不会哭”的电脑
OpenClaw 默认就有读你文件、跑命令的能力。强烈不要装在你正在用的工作电脑上。建议:
-
• 一台空闲的 Mac mini / 旧笔记本 -
• 一台树莓派 5(8G 内存以上) -
• 一台 2 核 4G 的云服务器(阿里云、腾讯云、Vultr 都行) -
• 实在没有,那就在你电脑上新建一个用户账号 openclaw,登进那个账号操作
8.2 一个 LLM 的 API Key
OpenClaw 自己不带模型,得接外部”大脑”。这篇教程默认用 DeepSeek,理由很简单:
-
• 国内不用翻墙,直接通 -
• 极便宜—— deepseek-chat比 Claude Sonnet 便宜一个数量级,新手试错成本极低 -
• 支持工具调用(function calling),OpenClaw 的 Skills 系统能正常跑 -
• 充值门槛低,人民币微信/支付宝都能付
|
|
|
|
|---|---|---|
| DeepSeek | 本教程默认
|
|
|
|
|
|
|
|
|
|
|
|
|
|
去 https://platform.deepseek.com 注册,在 API Keys 页面点 Create new API key,你会拿到一个 Key,长这样:
sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx⚠️ 这个 Key 只显示一次,关了页面就再也看不到——立刻粘贴到密码管理器或本地文件里(不要传到 git)。等会儿 onboard 会问你要它。
8.3 至少一个聊天软件账号
本教程用微信作为入门渠道。原因:
-
• 国内几乎人人有微信,不用专门下新 App -
• 微信官方近期上线了**”微信 ClawBot”插件**,直接在微信 App 的”我 → 设置 → 插件”里就能拿到一键安装命令——不再需要折腾第三方 Pad 协议、不用买 Padlocal Token、也不再有过去那种”封号高悬”的灰色地带 -
• 适合”家庭群管理员”这种最自然的入门用法
⚠️ 即便有了官方插件,以下几条还是建议你遵守:
-
1. 不要用主号绑机器人,留个小号 -
2. 不要把机器人拉进大群(可能被群员举报为骚扰) -
3. 不要让 Molty 主动加好友 / 群发 -
4. 不要在公司敏感场景里挂上”插件”——你公司可能有自己的合规要求 -
5. 关注插件状态——任何”插件”产品都可能下线或限流
如果你做的是工作场景,直接用企业微信(走官方 OpenAPI,合规稳妥)。这篇文章先讲个人微信,因为它对绝大多数读者最自然。
九、安装(三种方式,挑一种)
方式 1:npm 全局安装(最常用)
前置条件:Node.js ≥ 22.14(强烈推荐 24)。
# 装 node(用 nvm 最方便)curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bashnvm install 24# 装 OpenClaw 主体npm install -g openclaw@latest🦞 微信通道是单独的插件:本教程的微信对接走的是”微信 ClawBot”官方插件,不在 OpenClaw 主包里——主包只装 OpenClaw 本身就够了,微信通道在第十节第 4 关再单独从微信 App 里复制一条 npx 命令安装,后面会演示。
验证:
openclaw --version# 应该看到类似 v2026.4.14🦞 报
command not found?你的 PATH 没刷新。开个新终端,或者source ~/.bashrc/source ~/.zshrc。
方式 2:一键脚本(macOS / Linux)
curl -fsSL https://openclaw.ai/install.sh | bashWindows 用 PowerShell:
iwr -useb https://openclaw.ai/install.ps1 | iex⚠️ 一键脚本很方便,但只在你信任源的情况下用。任何
curl | bash的命令都是把别人的代码不审核就跑——OpenClaw 官方脚本是安全的,但养成审脚本的习惯。
方式 3:Docker(推荐给云服务器)
docker run -d \ --name openclaw \ -p 18789:18789 \ -v openclaw-data:/data \ ghcr.io/openclaw/openclaw:latest然后 docker exec -it openclaw openclaw onboard 进去做引导。
Windows 用户的特别说明
OpenClaw 官方”强烈推荐”WSL2,不要直接在 PowerShell 里硬装。
# 装 WSL2 + Ubuntuwsl --install -d Ubuntu# 进 Ubuntu 后再按 macOS/Linux 步骤来十、第一次跑 Onboard(精确到分钟)
装好之后,只要敲一个命令:
openclaw onboard它会启动一个交互式向导,带你过 4 个关:
┌──────────┬──────────┬──────────┬──────────┐│ 1. 模型 │ 2. 网关 │ 3. 工作 │ 4. 渠道 ││ (大脑) │ (水族箱) │ 空间 │ (嘴耳) │└──────────┴──────────┴──────────┴──────────┘下面按 5 分钟时间线一步步来。
第 1 关 · 选大脑(配置 DeepSeek)
? Model/auth provider? Anthropic (Claude) OpenAI Moonshot (Kimi) > DeepSeek ← 选这个 Local / Ollama Other (custom)选 DeepSeek,然后粘贴你刚拿到的 API Key:
? Enter DeepSeek API key: sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx✓ Key validated.? Default model? > deepseek-chat ← 默认就行,通用 + 极便宜 deepseek-reasoner ← 需要推理时再切新手默认选 deepseek-chat——通用、便宜、工具调用稳。等你以后做复杂代码或多步推理时再切到 deepseek-reasoner。
🦞 DeepSeek 用的是 OpenAI 兼容 schema——OpenClaw 在底层会自动用 OpenAI 协议跟它说话,你不需要操心。后面如果想自己手改
~/.openclaw/openclaw.json,大致长这样:"providers": { "deepseek": { "api_key": "${DEEPSEEK_API_KEY}", "base_url": "https://api.deepseek.com/v1", "models": ["deepseek-chat", "deepseek-reasoner"], "schema": "openai" }}
第 2 关 · 开网关
? Gateway port? (default: 18789)> 18789? Install gateway as a system daemon? (Y/n)> Y ← 一定选 Y选 Y。Daemon 模式意味着开机自启、后台常驻——龙虾🦞需要 24 小时在水族箱里游,不能你关电脑它就死。
✓ Gateway installed as daemon.✓ Started on http://localhost:18789打开浏览器访问 http://localhost:18789,看到 OpenClaw 控制台 = 网关活了:
┌──────────────────────────────────────────┐│ 🦞 OpenClaw Control ││ ─────────────────── ││ Status: Running ││ Gateway: http://localhost:18789 ││ Model: deepseek-chat ││ Channels: 0 connected ││ Workspace: not configured │└──────────────────────────────────────────┘第 3 关 · 建工作空间(新版本安装程序可能没有)
? Workspace name?> personal ← 随便起? Description? (optional)> 我的个人助理 ← 也随便填第一个工作空间叫什么都行,后面可以再建第二、第三个。
第 4 关 · 绑微信(走官方”微信 ClawBot”插件)
? Select channel (QuickStart)? Telegram WhatsApp Discord Slack WeCom (企业微信) DingTalk (钉钉) Feishu (飞书) > Skip for now (我等会单独装) ← 选这个⚠️ 注意:微信通道不在 onboard 列表里也没关系——本教程走的是微信官方刚推出的 “微信 ClawBot”插件,它不需要在 onboard 里选,而是从你手机微信 App 的”插件”页里复制安装命令,在终端里跑一下就好。
所以 onboard 这一步选 Skip for now,先把 onboard 收尾,然后我们一起去手机上拿那条命令。
✓ Onboard complete. Gateway: http://localhost:18789 Workspace: personal Channels: 0 (你将单独加微信)4.1 在微信 App 里拿到安装命令
打开你手机上的微信(或电脑版微信),按下面的路径走:
微信 → 我 → 设置 → 插件 → 微信 ClawBot → 详情┌──────────────────────────────┐│ ⚙️ 设置 ││ ───────── ││ 通用 ││ 通知 ││ 隐私 ││ 插件 ←─── 点这里 ││ 关于微信 │└──────────────────────────────┘ ↓┌──────────────────────────────┐│ 插件 ││ ──── ││ 📂 微信收藏 ││ 📷 微信小程序 ││ 🦞 微信 ClawBot [详情] ││ 让 OpenClaw 接进微信 │└──────────────────────────────┘ ↓┌──────────────────────────────────────┐│ 🦞 微信 ClawBot ││ ───────────── ││ 描述: 在你的电脑上跑 OpenClaw, ││ 通过微信和它对话 ││ ││ 安装命令: ││ ┌────────────────────────────────┐ ││ │ npx -y @tencent-weixin/ │ ││ │ openclaw-weixin-cli@latest │ ││ │ install │ ││ │ [📋 复制] │ ││ └────────────────────────────────┘ ││ ││ 状态: 未连接 │└──────────────────────────────────────┘点页面里的 📋 复制 按钮,你拿到的就是这条命令:
npx -y @tencent-weixin/openclaw-weixin-cli@latest install🦞 关于这条命令:
@tencent-weixin/openclaw-weixin-cli是微信官方维护的 npm 包,-y是免确认、@latest是拉最新版、install是子命令——它会自动检测本地的 OpenClaw 网关、把自己注册成一个新的 channel,并准备好和微信 App 配对。
4.2 在终端里运行这条命令
回到你装 OpenClaw 那台电脑的终端,直接粘贴回车:
npx -y @tencent-weixin/openclaw-weixin-cli@latest install你会看到:
[openclaw-weixin] 已找到本地安装的 openclaw[openclaw-weixin] 检测到 OpenClaw 版本: 2026.4.29[openclaw-weixin] 匹配 dist-tag: latest[openclaw-weixin] 正在安装插件 @tencent-weixin/openclaw-weixin@latest...openclaw-weixin] Resolving clawhub:@tencent-weixin/openclaw-weixin@latest…Downloading @tencent-weixin/openclaw-weixin@latest…Extracting /tmp/openclaw-npm-pack-xzOwQs/tencent-weixin-openclaw-weixin-2.3.1.tgz…Plugin "openclaw-weixin" has 2 suspicious code pattern(s). Run "openclaw security audit --deep" for details.Installing to /home/alexander/.openclaw/extensions/openclaw-weixin…Installing plugin dependencies…Installed plugin: openclaw-weixinRestart the gateway to load plugins.[openclaw-weixin] 插件就绪，开始首次连接...Config warnings:- plugins.entries.openclaw-weixin: plugin openclaw-weixin: channel plugin manifest declares openclaw-weixin without channelConfigs metadata; add openclaw.plugin.json#channelConfigs so config schema and setup surfaces work before runtime loads- plugins.entries.openclaw-weixin: plugin openclaw-weixin: channel plugin manifest declares openclaw-weixin without channelConfigs metadata; add openclaw.plugin.json#channelConfigs so config schema and setup surfaces work before runtime loadsConfig warnings:- plugins.entries.openclaw-weixin: plugin openclaw-weixin: channel plugin manifest declares openclaw-weixin without channelConfigs metadata; add openclaw.plugin.json#channelConfigs so config schema and setup surfaces work before runtime loads- plugins.entries.openclaw-weixin: plugin openclaw-weixin: channel plugin manifest declares openclaw-weixin without channelConfigs metadata; add openclaw.plugin.json#channelConfigs so config schema and setup surfaces work before runtime loads4.3 自动弹出二维码,扫码连接
npx安装完成openclaw-weixin-cli后,终端会自动弹出一个二维码(macOS / Linux 是 ASCII 码字符二维码;Windows / 远程服务器场景会同时打印一个 https://liteapp.weixin.qq.com/q/7GiQu1?qrcode=xxxxxxx&bot_type=3 网址,打开是图片版):
正在启动...用手机微信扫描以下二维码，以继续连接：▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄█ ▄▄▄▄▄ █▄▄▄ ▀ ▄██ ▀▀ ██▄▄██ █ ▄▄▄▄▄ ██ █ █ ██▄▀ █ ▄▄▀██▄ ▄▄█▄▄▀▀█ █ █ ██ █▄▄▄█ ██▀▄ ▄▄▀█▄▄ ▄ ▄█▀ ▀ ███ █▄▄▄█ ██▄▄▄▄▄▄▄█ ▀▄█ ▀▄█▄█▄▀▄█▄█▄▀▄█▄█▄▄▄▄▄▄▄██ ▄▀ ▀▄▀▀ ▀█▄██▀█▄▀ █▄▀▄▀ ██▄▀▀██▀▄██▄██ ▄▄ ▀▄██▄▄ ▄█▀▄█▀▄▀▄██ ▄▄▀ ▄▄ ▄▄███ ▀ ▀▀▄▄▀▄▄█▀▄ ▀█▄▄▄██ ▀ █▀▄▀▄▄▀ ▀ ▄███▀ █▀█▄ ██▀█▀▀ █▄█▄██▄█▀▄█▄██▀▀ █▀▄ ███ ▄▀ ▀▄▄▄▄ ▄███▄▀▀▀ ██▄▀▄▀▀█▀▄ █ ▄▄▄██▄▀█ █▄▄▀▄▀█▀▄ ▄▄ █▄▄▄██▄█ █ ▀ ▀▄█▀██ ██▄▄ ▄█▄█ ▄█▄▀ █ █▄▀ █▄ ▀██▀▄▄▄▄ █ ▄██ ▄█▀ █▄█▄ █ ▀ █ ▄ ▀█ ▄▀ ██ ▀██▄ ▀▀ ██ ▄▀▄▀ ▄▀▄▀▄▄▄ ▀▀ █▄▄▀██ ▄█▄ ▄▄█▀▄▀▀▄██ ▄ ▀▄▄█▄█ ▄▄█ ██▄▄▄██▄█▄ ▄▄█▄▀▀ ▄ ██▄█▄██▄▄█ ▀▀▀▀ █▀▄▀███▄▄▄▀█ ▄▄▄ ▀ ███ ▄▄▄▄▄ ██▄ ▄▀█▀ ▄▀▄▄██ █ ▄█ █▄█ ▄▀ ██ █ █ █ █▄█▄▄ ▄ █▀▄ ▄█▄ ▄ ▀▀▀██ █▄▄▄█ █▀█ █▄█ █ ▀▄▄█▄▀▄▄ █▀▀ ▄▀▀▀ ██▄▄▄▄▄▄▄█▄█▄██▄▄▄██▄▄▄██▄▄███▄█▄▄▄▄██▄█若二维码未能显示或无法使用，你可以访问以下链接以继续：https://liteapp.weixin.qq.com/q/7GiQu1?qrcode=xxxxxxxxxxxxx&bot_type=3正在等待操作...打开手机微信,点右上角”+”→”扫一扫”,扫这个二维码。
点 确认绑定。终端会自动重启openclaw-gateway.service
4.4 试一下
打开微信,给微信ClawBot发一条消息:
你: 你好🦞 Molty: 你好!我现在跑在 your-computer 这台机器上。 我能帮你读文件、跑命令、查信息、记事情……需要点啥?收到这条消息 = 你的 OpenClaw 已经活了。
十一、让它做第一件实事
光打招呼不够,试点真的:
例子 1:查端口占用
你: 我的 3000 端口被谁占了?🦞 Molty: 查询中... PID 23145, 进程名: node, 启动命令: node /Users/you/projects/web/server.js 要杀掉吗?你: 先别,告诉我这是哪个项目🦞 Molty: 看启动命令路径,是你 ~/projects/web 项目。 它在 3 小时前启动,占用 142 MB 内存。它跑了 lsof -i :3000,认出了路径。
例子 2:让它定时催你
你: 每天晚上 11 点提醒我喝水睡觉🦞 Molty: 已添加 Cron 任务: - 名字: water-and-sleep - 时间: 每天 23:00 - 内容: "兄弟,该喝水睡觉了" - 通过: wechat-personal 渠道发给你 要改时区或文案吗?它写了一个真正的 Cron 任务,以后每天 23 点你都会主动收到推送。你不用打开任何东西,它会主动找你——这是 ChatGPT 的第三个永远做不到的事。
🦞 小贴士:这一步还没装额外 Skill 也能做——这些是 OpenClaw 装好就自带的”基础动作”(文件 / 命令 / Cron / 消息发送)。装更多 Skill 后能做的事会指数级增加。
十二、跑通后,你已经掌握的概念
这十几分钟里你不知不觉用上了 OpenClaw 的全部 5 个核心概念:
┌────────────┬───────────────────────────────────┐│ 概念 │ 你刚刚做了什么 │├────────────┼───────────────────────────────────┤│ Gateway │ 装了 daemon,跑在 18789 ││ Workspace │ 建了一个叫 personal ││ Channel │ 绑了微信(走"微信 ClawBot"官方插件) ││ Skill │ 用了 filesystem、shell、cron 三个内置││ Sandbox │ 默认开着(看不见但工作了) │└────────────┴───────────────────────────────────┘下一步就是把这五个概念分别玩深玩透,从”跑通”到”用好”。
十三、第一次跑没成功?查这五个坑
坑 1:openclaw: command not found
# 检查 npm 全局 bin 在不在 PATH 里npm config get prefix# 输出例如 /usr/local# 那 /usr/local/bin 应该在 PATH 里echo $PATH | grep "/usr/local/bin"如果不在,加到 ~/.bashrc 或 ~/.zshrc:
export PATH="$(npm config get prefix)/bin:$PATH"坑 2:onboard 卡在 “validating key”
99% 是 API Key 错了或网络问题。
# 手动测一下 DeepSeek 能不能通curl https://api.deepseek.com/v1/chat/completions \ -H "Authorization: Bearer $DEEPSEEK_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "deepseek-chat", "max_tokens": 10, "messages": [{"role":"user","content":"hi"}] }'正常应该返回一段 JSON,里面有 "content": "Hi! ..."。如果返回 401 = Key 错;如果直接连接超时 = 网络问题。
加代理(如果你刚好不在国内或走代理):
export HTTPS_PROXY=http://127.0.0.1:7890openclaw onboard坑 3:微信 ClawBot 装不上 / 扫不上 / 不回消息
最常见的几种情况:
原因 1: npx 跑不通(npm 源国内慢) → 切淘宝镜像: npm config set registry https://registry.npmmirror.com → 重新跑那条 npx -y @tencent-weixin/openclaw-weixin-cli@latest install原因 2: 终端报"未检测到 OpenClaw gateway" → 你 onboard 还没跑完,或者 daemon 没起 → 先 openclaw daemon start,再访问 localhost:18789 确认网关活着原因 3: 二维码过期(60 秒超时) → 重新跑 install 命令,或浏览器打开 http://localhost:18789/wechat/qr 刷新原因 4: 微信 App 里找不到"微信 ClawBot"插件 → 把微信 App 升级到最新版(插件页是新功能,老版本没有) → 仍然看不到的话,可能区域没灰度到——换微信账号或等几天再试原因 5: 二次确认弹窗里点错了"取消" → 重新跑 install,扫码,这次点"确认绑定"原因 6: 你想让别人也能用,但他们发消息没反应 → 默认只有绑定者能驱使 Molty → 去 localhost:18789 → Channels → wechat-bot → Allowed users 加白名单坑 4:网关启动了但端口冲突
# 看 18789 是不是被占了lsof -i :18789被占了就改一个端口:
openclaw config set gateway.port 7799openclaw daemon restart坑 5:Daemon 装了,但重启电脑后没跑
可能是 daemon 配置没启用。
# macOSlaunchctl list | grep openclaw# Linux (systemd)systemctl --user status openclaw如果没列出来,手动启用:
openclaw daemon installopenclaw daemon start十四、四条必须知道的安全红线(看完再上手)
OpenClaw 强大,因为它真的能动手。强大的另一面是危险。
红线 1:不要装在你的工作电脑上
它默认能 rm、能 git push --force、能改你的 SSH 配置。一句”帮我清理一下下载文件夹”,可能把你昨晚下载的合同删了。
✅ 装在专用机器、虚拟机、新建用户、Docker 容器里。
红线 2:API Key 是钱,泄露 = 烧光
# OpenClaw 把 Key 存在这里:~/.openclaw/config.json# 别这样:git add ~/.openclaw/git commit -m "my config" # ❌ 你刚把 Key 推上 GitHub✅ 在 DeepSeek / Anthropic / OpenAI 后台设月度上限(默认开)。DeepSeek 后台叫”账户额度”,一定先把它设成你能接受的最坏数字(比如 50 块),炸不开你的钱包。
红线 3:沙箱默认开,但你别关
// openclaw.json{ "sandbox": { "type": "docker", // ✅ 推荐 // "type": "none" // ❌ 千万别这样 }}沙箱关闭后,Agent 跑的命令直接在你主系统里执行。任何”我帮你优化一下系统”都可能毁机。
红线 4:第一周,什么都先 Dry-Run
你给它指令时,加一句”先告诉我你打算做什么,不要直接做”。等你信任它三五天再放手。
你: 帮我清理 Downloads 里 30 天前的文件🦞 Molty: 计划: - 扫描 ~/Downloads/ - 找到 mtime > 30 days 的文件 - 列出来给你确认 - 你说"删"我才删 要继续吗?把这种计划-确认-执行做成习惯,你不会哭。
十五、本篇知识地图
┌──────────────────────────────────────────────────┐│ OpenClaw 完整入门 知识地图 ││ ││ 一句话: 自托管的、跨渠道的、能动手的 个人 AI Agent ││ ││ 五个关键词(龙虾比喻): ││ Gateway = 水族箱(常驻进程) ││ Workspace = 脑子(配置 + 模型 + 提示词) ││ Channel = 嘴和耳(聊天软件适配器) ││ Skill = 爪子(动手能力单元) ││ Sandbox = 试衣间(隔离执行环境) ││ ││ 四步上手: ││ 1. npm install -g openclaw ││ 2. openclaw onboard ││ ├─ 大脑选 DeepSeek (sk-xxx) ││ ├─ 模型选 deepseek-chat ││ ├─ 网关装成 daemon ││ ├─ 工作空间叫 personal ││ └─ 渠道这一步选 Skip ││ 3. 微信 → 我 → 设置 → 插件 → 微信 ClawBot → ││ 详情 → 复制安装命令,在终端跑: ││ npx -y @tencent-weixin/ ││ openclaw-weixin-cli@latest install ││ 4. 终端自动弹二维码 → 微信扫码 → 确认绑定 ││ ││ 五个最常见坑: ││ 1. PATH 没刷新 (command not found) ││ 2. DeepSeek Key 错或网络不通 ││ 3. 微信 ClawBot 装不上 / 二维码过期 ││ 4. 18789 端口冲突 ││ 5. Daemon 没自启 ││ ││ 三个误会避坑: ││ × 不是 ChatGPT 套壳 ││ × 不是本地 Claude Code ││ × 不是付费 SaaS ││ ││ 四条安全红线: ││ ├── 不装工作电脑 ││ ├── API Key 不上 git + 设月度上限 ││ ├── 沙箱默认开 ││ └── 头一周 Dry-Run ││ │└──────────────────────────────────────────────────┘十七、扩展学习资源
必读
-
• OpenClaw 官方入门指南[1] — 一手信息源 -
• DeepSeek 平台文档[2] — 拿 Key、查余额、看模型说明 -
• @tencent-weixin/openclaw-weixin-cli (npm)[3] — 微信 ClawBot 插件的 CLI 包,看版本、看变更 -
• 微信 ClawBot 插件介绍页[4] — 微信官方对插件的说明(以微信 App 内”插件 → 微信 ClawBot → 详情”为准)
推荐
-
• DataWhale·一周打造跨设备 AI 助手[5] — 比较友好的中文系统课 -
• 菜鸟教程·OpenClaw 快速上手[6] — 短小精悍版 -
• Apifox·安装与使用图文教程[7] — 截图特别多 -
• 知乎·OpenClaw 安装与运行教程[8] — 国内网络环境补充
动手实践
-
• 把第十一节”试 1/2″全部跑一遍 -
• 加一条 Cron:每天早上 8 点告诉你天气(它会自己用 web skill 查)
下一篇预告:你刚刚跑过的 onboard,其实生成了一个叫
openclaw.json的核心配置文件——大脑、网关、工作空间、渠道全都写在里头。下一课我们要把这个文件扒开看,让你能脱离向导手动改任何配置;同时把 DeepSeek 之外的备用大脑(Claude / Kimi / 本地 Ollama)都接上去,组建你自己的”模型矩阵”,做到便宜的活给便宜的脑、复杂的活给聪明的脑。这是从”用户”升级到”玩家”的第一步。
觉得有用的话，点个关注吧!大模型方面你想看什么？留言区说，我来写。
声明：本博客内容素材来源于网络，文章由AI技术辅助生成。如有侵权或不当引用，请联系作者进行下架或删除处理。
引用链接
[1] OpenClaw 官方入门指南: https://docs.openclaw.ai/zh-CN/start/getting-started[2] DeepSeek 平台文档: https://platform.deepseek.com[3] @tencent-weixin/openclaw-weixin-cli (npm): https://www.npmjs.com/package/@tencent-weixin/openclaw-weixin-cli[4] 微信 ClawBot 插件介绍页: https://weixin.qq.com/clawbot[5] DataWhale·一周打造跨设备 AI 助手: https://github.com/datawhalechina/openclaw-tutorial[6] 菜鸟教程·OpenClaw 快速上手: https://www.runoob.com/ai-agent/openclaw-quickstart.html[7] Apifox·安装与使用图文教程: https://apifox.com/apiskills/openclaw-installation-and-usage-guide/[8] 知乎·OpenClaw 安装与运行教程: https://zhuanlan.zhihu.com/p/2005987429828534912