本文由 莫潇羽@源码七号站(www.fuyuan7.com)撰写,转载请注明出处。
快速摘要
如果你只想拿走结论,这几句就够了:OpenClaw 不是又一个聊天机器人,它是一个跑在你自己机器上的「执行网关」,能读写文件、跑 shell、控浏览器、调 API。真正决定它好不好用的,从来不是模型多强,而是三样东西——workspace 里那几个 Markdown 人格文件写得对不对、Skill 装得干不干净、以及你有没有把安全边界先划出来。落地路径我建议按这个顺序走:先用轻量云服务器的应用模板把服务跑起来,再用飞书长连接把指挥入口打通,然后用 SOUL.md 和 USER.md 把「它是谁、它服务谁」定死,最后才谈自动化业务流。至于内容自动分发,2026 年这个时间点我的建议是踩刹车——机器负责生产,人负责审核和按下发布键,这条线不能越。
下面是完整拆解:我会把部署、通道、人格、技能、内容流水线、多智能体、安全加固这七块拆开讲,每一块都给出可直接照抄的配置和命令,也会把我自己踩过的坑标出来。想看完整拆解,往下翻。
一、先把 OpenClaw 到底是什么讲清楚
1.1 它和你平时用的 AI 助手不是一类东西
很多人第一次听说这个项目,第一反应是「又一个套壳」。这个判断不太准确。
用一句白话解释:你平时用的对话式 AI,是「你问一句、它答一句」,它给你的是文字;OpenClaw 给你的是「事情做完了」。 它拿到的不只是一个对话框,而是宿主机的操作权限——可以执行 shell 命令、读写本地文件、驱动浏览器、调用各种外部 API。所以社区里管它叫「能动手干活的数字员工」,这个说法虽然营销味重了点,但方向没错。
项目本身的来龙去脉值得交代一下,因为这决定了它的设计取向。它由奥地利开发者 Peter Steinberger 创建,最初只是一个周末项目,目标是做一个通过聊天软件控制的本地 AI 助手,核心理念是「让 AI 通过你已经在用的聊天 App 跟随你」。它不在浏览器沙盒里跑,而是直接运行在宿主机操作系统层——这一点是它全部威力的来源,也是它全部风险的来源,后面第十章我会专门展开。
项目历史上换过好几次名字,曾用名 Clawdbot、Moltbot,所以你在网上搜到的老教程里出现这几个词,指的是同一个东西。国内社区习惯叫它「小龙虾」,是因为项目 Logo 和 claw(爪子)这个词的关系,纯属昵称,跟功能没关系。
1.2 三个定语:开源、本地优先、多通道
我自己折腾下来,觉得把它的特征概括成三条最省事:
开源。 基于 MIT 协议,代码公开。这意味着你可以完全私有化部署,也意味着你必须自己对安全负责——没有厂商替你兜底。
本地优先。 支持数据本地化运行,规避第三方服务器传输风险,实现数据自主可控。对于要处理内部文档、客户资料的团队,这一条是刚需。
多通道接入。 这是它体验上真正拉开差距的地方。你不需要再开一个新的 App,直接在飞书、企业微信、钉钉这些你每天已经在用的工具里跟它说话就行。腾讯云那边在云端一键部署 OpenClaw,微信、QQ、企业微信、飞书、钉钉等国内主流 IM 已经全面支持,对国内用户来说省了很多折腾。
1.3 它的运行逻辑长什么样
理解架构不需要看源码,画张图就够了。整体是一个典型的中枢辐射结构:
flowchart TD
A["聊天入口<br/>飞书 / 企微 / 钉钉 / 网页控制台"] --> B["网关 Gateway<br/>消息接入 + 鉴权 + 路由"]
B --> C["Agent 运行时<br/>组装人格 + 上下文 + 工具清单"]
C --> D["大模型<br/>推理与规划"]
D --> C
C --> E["Skills 技能层<br/>可插拔的手和脚"]
E --> E1["shell / 文件读写"]
E --> E2["浏览器自动化"]
E --> E3["第三方 API 调用"]
C --> F["记忆层<br/>MEMORY.md + 每日日志 + 向量库"]
F --> C
这张图里最容易被新手忽略的是两个地方。
一个是记忆层是双向的。它不是「跑完就忘」,而是会把重要的事沉淀成文件,下次启动继续用。这也是它跟大部分编码助手最本质的差别——Claude Code 是有状态会话内、无状态会话间的编码工具,OpenClaw 是始终在线、跨会话持久化的个人助手。
另一个是Skills 层是可插拔的。模型本身不会用微信公众号 API,也不会操作飞书多维表格,这些能力全靠技能包挂上去。所以你的数字员工能干什么,本质上取决于你给它装了什么技能、以及技能写得好不好。
1.4 一个我认为很关键的心态问题
网上不少教程会给你一种错觉:装完就能用,一句话让它干什么都行。
我的实际体验不是这样。它更像是招了一个能力很强但完全不了解你公司的应届生——什么都能学,但你不告诉它,它什么都不知道。所以社区里那个「养」的说法其实挺贴切:这不是一次性配置,而是一个持续投喂上下文、持续修正边界的过程。 你今天教它你们的选题标准,明天教它你们的排版规范,它才逐渐变成对你有用的东西。
想明白这一点,后面所有的操作才有意义。莫潇羽@源码七号站 在这块上走过弯路——一开始总想着找一个「万能提示词」一劳永逸,后来才发现,把功夫花在结构化的人格文件和技能定义上,比堆提示词有用得多。
二、新手最容易翻车的五个地方
我把这一节提到前面,是因为这些坑几乎每个人都会撞一遍。先看一眼,后面遇到就不慌了。
|
现象 |
你以为的原因 |
真实原因 |
处理方向 |
|
飞书里发消息,机器人回一句英文「access not configured」还带一串码 |
配置失败了 |
这是正常的配对流程,不是报错 |
把提示里的配对命令拿到服务器上执行一次 |
|
事件订阅页面保存时提示「未检测到应用连接信息」 |
权限没开够 |
服务端还没建立起长连接 |
先让服务跑起来并连上,再回来保存订阅方式 |
|
让它做某件事,它一本正经拒绝了 |
模型能力不行 |
人格文件里的角色定位把任务范围锁死了 |
要么改人格定义,要么开一个新的 Agent |
|
任务一直「思考中」,几十分钟没动静 |
模型太慢 |
多半是某个外部接口被拒,任务卡在重试里 |
去看网关日志,别在聊天窗口里干等 |
|
技能装不上,一直超时 |
网络断了 |
部分技能仓库在境外,直连不稳定 |
用离线技能包,或者切国内镜像源 |
这五条里,第三条最反直觉,也最值得单独说两句。
我第一次遇到是这样:先把数字员工的角色定义成了「新媒体研究员,专注 AI 赛道选题」,过了两天想让它顺手做一个跟内容无关的数据整理任务,它直接回绝了,理由是「这不在我的职责范围内」。当时还愣了一下,以为是模型抽风。
后来才反应过来——这恰恰说明人格文件生效了。它是严格按照你写的职责边界在办事。这个机制本身是好的,能防止智能体乱跑,但你要知道它的存在,否则会误判成故障。正确的处理不是反复去改那份人格文件(改来改去会把定位改得四不像),而是按职能拆成多个 Agent,各管一摊。这个思路我在第九章会展开。
第一条也说一下。机器人会回复类似「OpenClaw: access not configured. Your Feishu user id: ou_xxx,Pairing code: XXXXXX,Ask the bot owner to approve with: openclaw pairing approve feishu XXXXXX」的配对信息。很多人看到英文报错就慌了,其实这是设计好的安全机制:它不认识你,需要机器主人在服务端确认一次你是谁。 每个实例生成的配对码都不一样,跟着提示做就行,不用怀疑自己装错了。
三、把服务跑起来:本地还是云端,怎么选
3.1 先做选择题,别急着敲命令
部署方式无非本地和云端两条路,各有各的合适场景。我做了张表对比一下:
|
维度 |
本地部署(Mac / Windows / 自购小主机) |
云端部署(轻量应用服务器) |
|
常驻在线 |
得让机器一直开着 |
天然 7×24 |
|
数据边界 |
数据不出本机,隐私性最好 |
数据在云上,需要自己做隔离 |
|
出口 IP |
家宽或办公网,动态变化 |
固定公网 IP |
|
对本机的影响 |
智能体有本机高权限,误操作会伤到你自己的文件 |
与本地物理隔离,炸了重装就行 |
|
上手难度 |
环境依赖要自己解决 |
应用模板一键起 |
|
适合谁 |
想让它管本地文件、做个人助理 |
想让它对接外部平台、跑定时任务 |
我的建议很明确:如果你的目标是对接公众号、飞书这类需要固定出口 IP 和常驻在线的业务,直接上云端。 别在本地折腾,因为你迟早会撞上「IP 白名单填了没用,因为家里宽带 IP 变了」这个问题,白白浪费半天。
反过来,如果你只是想让它帮你整理本地的一堆文档、改改代码,那本地部署更合适,也更安全——数据压根不出门。
云端还有一个被低估的好处:隔离。提供独立云端环境,与本地电脑物理隔离,保障本地隐私安全。考虑到这东西有 shell 执行权限,把它关在一台可以随时重装的机器里,心理压力小很多。
3.2 云端部署:应用模板路径
现在主流云厂商基本都提供了预置镜像,不需要你手工装依赖。以腾讯云轻量应用服务器(Lighthouse)为例,路径是这样的:
登录控制台进入轻量应用服务器产品页,在新购或重装页面选择「使用应用模板」,找到「AI 智能体」分类下的 OpenClaw 镜像。注意一点:重装系统会清空服务器上的所有数据,请务必提前备份,如果是拿一台在跑别的东西的机器来改,先想清楚。
配置怎么选?这里给个通用判断,不给具体价格,因为云厂商的套餐和活动价变动非常频繁,我写稿时看到的和你看到的大概率不一样,请以官方购买页面的实时报价为准。
|
配置档位 |
适用场景 |
我的判断 |
|
最低档(1 核 2G 左右) |
纯试水,跑通流程 |
能跑,但装技能、跑浏览器自动化时容易卡 |
|
中档(2 核 4G) |
个人 / 小团队日常使用 |
推荐从这一档起步,性价比最合适 |
|
高档(4 核 8G 及以上) |
多 Agent、频繁跑自动化任务 |
有明确需求再上,不用一步到位 |
内存建议 4G 起步,AI 任务比较吃内存,2G 的机器跑起来会有点捉襟见肘——这个经验我认同,实测下来 2G 在装技能包的时候确实容易触发超时。
一个容易被忽略的选择项是地域。有些教程会推荐选海外区域,理由是访问某些海外接口更顺畅。这里必须明确一句:如果你的业务要对接微信公众号、飞书、企业微信这些境内平台,请老老实实选国内地域。 腾讯云自己的说明也是微信 / QQ / 企微 / 飞书等国内主流 IM 应用推荐国内地域套餐。境内平台的接口对访问来源本身就有约束,跨境访问只会给你增加不必要的麻烦。
3.3 装完先做三件事,再谈别的
镜像跑起来之后,控制台会有一个应用管理面板,先确认服务状态是「运行中」。如果不是,重装一次应用通常就好了——拉取过程偶尔会出问题,这不是什么大毛病。
接着登录服务器,做三件事:
# 1. 确认系统版本和资源,别在配置不足的机器上折腾半天
cat /etc/os-release | grep VERSION
free -h && lscpu | grep "^CPU(s)"
df -h /
# 2. 记下这台机器的公网出口 IP,后面配平台白名单要用
curl -s https://myip.ipip.net || curl -s ifconfig.me
# 3. 看清楚配置目录在哪,这是后面所有操作的根
ls -la ~/.openclaw/
第二条我要重点强调。很多人在后面配置微信公众号接口时卡住好几个小时,根因就是没搞清楚「哪个 IP 才是真正发出请求的那个」。 云服务器控制台上显示的公网 IP,绝大多数情况下就是出口 IP,但也存在不一致的情况。稳妥做法是在服务器上实际发一个请求出去看看,或者直接看平台返回的报错——报错信息里会明明白白写着它看到的来源 IP 是什么。
3.4 配置目录:先认门牌号
~/.openclaw/ 这个目录是整个系统的家。你后面所有的「调教」动作,本质上都是在改这里面的文件。先认个脸熟:
~/.openclaw/
├── openclaw.json # 主配置文件(模型、通道、端口都在这)
├── workspace/ # 数字员工的「灵魂」目录,建议做 git 版本管理
│ ├── SOUL.md # 人格:它是谁、什么性格、什么原则
│ ├── USER.md # 用户画像:你是谁、你的偏好和禁区
│ ├── IDENTITY.md # 身份名片:叫什么名字、什么形象
│ ├── AGENTS.md # 多 Agent 路由规则与标准作业流程
│ ├── TOOLS.md # 工具备忘:什么工具怎么用
│ ├── MEMORY.md # 长期记忆索引
│ ├── HEARTBEAT.md # 定时自检与主动任务
│ └── skills/ # 已安装技能,一个技能一个子目录
├── agents/<cid>/ # 每个 Agent 的独立状态
├── memory/<cid>.sqlite # 向量记忆库
└── secrets.json # 凭证存储
这个结构是社区整理出来的通行版本,不同版本之间会有细微差异,部分版本里还会看到 BOOTSTRAP.md(初始化用完即删)和按日期切分的 memory/ 目录。以你本机 ls 出来的实际结构为准。
一句提醒放在这里最合适:secrets.json 和 workspace 目录里可能存