2026 年 1 月,OpenClaw 在不到两周内突破 17 万 GitHub Stars,成为 GitHub 历史上增长最快的开源项目之一。
它不是普通聊天机器人。它是一个可以 7×24 小时运行在自己服务器上的 AI Agent——
- 有"眼睛",能浏览网页
- 有"双手",能操作系统
- 能写代码、管理文件、处理任务
它不是问答工具。
它是执行系统。
这篇文章记录我从踩坑到跑通的全过程,也分享背后的结构思路。
一、为什么要自建?
在决定折腾之前,我问了自己三个问题:
- 我是否希望 AI 24 小时运行,而不是靠我手动触发?
- 我是否希望控制权在自己,而不是完全依赖某个平台?
- 我是否希望规则写好后,系统自动执行,而不是靠意志力?
如果答案是"是",那就值得折腾。
自建的意义不是炫技。
而是——把执行权从"情绪"交给"系统"。
二、安装 OpenClaw
OpenClaw 支持 Mac / Windows / Linux。推荐 Linux 服务器部署,但本地测试也完全可行。
安装只需一行命令:
curl -fsSL https://openclaw.ai/install.sh | bash这一行命令会自动:检测系统环境、安装 Node.js(≥22)、注册系统守护进程。
安装完成后确认版本:
openclaw --version首次运行会进入 onboarding 向导,建议这样处理:
- Gateway Port:默认 18789
- Gateway Bind:Loopback(飞书长连接无需公网)
- AI Provider:先跳过
- Chat Channel:先跳过
- Skills:先跳过
核心原则:先跑通主流程,不要一开始追求完整功能。
三、配置 AI Provider
前面跳过了 provider,现在补上。这一步决定系统能否真正"开口"。
我使用的是 MiniMax 2.5,国内访问稳定,响应速度不错。
打开配置文件:
openclaw config edit在 providers 中写入:
providers:
- name: minimax
type: minimax
apiKey: "你的 MiniMax API Key"
model: "abab6.5s-chat"保存后重启:
openclaw gateway restartAPI Key 在 MiniMax 开放平台申请即可。
四、对接飞书机器人
OpenClaw 内置飞书 channel 支持。采用 WebSocket 长连接——无需公网回调地址,无需验证 IP,配置比大多数渠道简单一个量级。
4.1 创建飞书应用
- 登录 open.feishu.cn
- 创建「企业自建应用」
- 添加能力 → 选择「机器人」
4.2 添加权限
在「权限管理」中添加:
im:message
im:message:send_as_bot
im:chat:readonly
contact:user.id:readonly4.3 事件订阅(重点)
进入「事件与回调」:
- 订阅方式:选择"使用长连接接收回调"
- 添加事件:
im.message.receive_v1
一定要选择长连接模式。这是无需公网地址的关键。
4.4 发布应用
创建版本 → 提交发布。
4.5 写入 OpenClaw 配置
填入 App ID 与 App Secret,重启 gateway:
openclaw gateway restart查看日志确认连接:
tail -f ~/.openclaw/logs/*.log | grep -i feishu看到 feishu connected 即成功。
五、跑通的那一刻
我在飞书群里发了一条消息:
ping
屏幕上出现输入动画。几秒后,它回:
pang
就一个字。但那一刻我知道——
这条链路通了。
AI 收到指令、处理、回应。
不是我点按钮,是系统在运行。
三天折腾,值了。
六、踩坑归类:其实只有三类问题
三天里踩了不少坑。但冷静下来,所有问题都能归类为三种:
① 环境冲突
Node 版本不匹配、代理端口变更未同步。
解决:统一运行环境,用 nvm 管理版本,必要时重启系统。
② 进程状态残留
端口占用、Gateway 僵死、认证失败。
解决:杀进程,重启 gateway。
③ 版本配置不匹配
OpenClaw 迭代极快,不同版本字段结构可能不同。
openclaw --version确认版本,再查对应文档。
当你能把错误归类,焦虑会消失。
调试不再是混乱,而是拆分。
七、从工具到系统
在飞书发一条指令。
几十秒后,AI 自动执行。
那一刻我意识到:这不是聊天。这是一种新的执行方式。
我写规则。
系统执行。
不依赖意志力。
这和投资纪律、跑步节律是同一个逻辑:
想明白,然后自动执行。
把决策放在清醒时。
把执行交给系统。
不让情绪插手。
OpenClaw 只是工具。
真正跑通的,是"系统思维"。
八、写在最后
OpenClaw 的 logo 是一只龙虾。
龙虾蜕壳时很痛。
但每一次蜕壳,都会长出更大的自己。
部署 AI 也是一样。
不要一次搞定所有。
先跑通主链路。
出错了,归类,拆解,再跑。
系统会越来越稳。
你也会。