最近折腾 OpenClaw 折腾得挺开心的。先是在 VPS 上装了一遍尝鲜,后来又在 Mac 和 Linux 上都跑通了。虽然网上教程已经不少,但我还是想写一篇自己的总结,毕竟实践过程中踩了不少坑,也有一些心得。
简单说,OpenClaw 就是一个开源的 AI 助手,跑在你自己的电脑上。你可以通过飞书、Telegram 这些聊天工具,或者 Web 界面跟它对话。它能帮你处理邮件、管理日历、写代码、控制智能家居——就像一个 24 小时在线的私人助理。
官方资源:
• 官网:https://openclaw.ai/ • GitHub:https://github.com/openclaw/openclaw • 文档:https://docs.openclaw.ai/zh-CN
好了,话不多说,直接开始。
安装 OpenClaw
整个流程其实就三步:装 OpenClaw → 跑 onboard 配置向导 → 开始用。
我这里主要在 Linux 下操作(Mac 基本一样)。
最简单的方式:npm 安装
npm install -g openclaw装完验证一下:
openclaw --version看到版本号就说明装好了。
其他安装方式
如果 npm 不方便,还有这些选择:
一键安装脚本
macOS / Linux:
curl -fsSL https://openclaw.ai/install.sh | bashWindows PowerShell:
iwr -useb https://openclaw.ai/install.ps1 | iex从源码安装(适合想折腾的)
git clone https://github.com/openclaw/openclaw.gitcd openclawpnpm installpnpm build配置向导
装好之后,运行:
openclaw onboard这个向导会带你完成所有配置,包括 AI 模型、聊天渠道、技能、Hooks 等等。
安全提示
首先会弹出安全警告,看完选 Yes 继续就行。
选择模式
◇ Onboarding mode│ QuickStart选 QuickStart 就好,会自动配置好端口(18789)和绑定地址(127.0.0.1)这些。
配置 AI 模型
这一步要选 AI 模型提供商,然后输入 API Key。
国内用户的省钱方案
Anthropic 和 OpenAI 的 API 不仅要国际信用卡,费用也不便宜。国内用户我推荐用阿里云百炼或者字节火山的月套餐。
不要问为什么首选这俩,问就是大厂真的优惠。
新用户的话,最低档月套餐优惠价不到 10 块钱。老用户也会给优惠券,差不多也就 10 块一个月。
关键是这两个平台不仅有自家的旗舰模型(阿里的 qwen3.5-plus、qwen3-max,字节的 Doubao-Seed-Code),还支持第三方模型,比如 kimi 2.5、GLM-4.7。
这种 ALL IN ONE 平台的好处就是选择多,哪个模型好用换哪个。
我这段时间主要用阿里的 qwen3.5-plus,速度挺快,关键是基本没有 Token 焦虑了。
阿里云百炼:https://www.aliyun.com/benefit/ai/aistar?clubBiz=subTask..12397051..10263..
注意阿里云百炼月套餐的 API-KEY 是 sk-sp- 开头的,跟阿里云通用 KEY 不一样,别搞混了。
阿里云百炼提供了两套兼容协议的 API 地址:
OpenAI 兼容:
https://coding.dashscope.aliyuncs.com/v1Anthropic 兼容:
https://coding.dashscope.aliyuncs.com/apps/anthropic字节火山也可以,我觉得差不多:https://volcengine.com/L/N2P_cZvd7jg/
配置聊天渠道
向导会让你选择聊天渠道:
◇ Select channel (QuickStart)我建议选飞书,下面说说怎么配。
第一步:创建飞书应用
去飞书开发者后台:https://open.feishu.cn/app?lang=zh-CN
创建应用后,在"应用能力"那里添加"机器人"能力。
然后在"开发配置" → "权限管理"这里添加权限。搜索 "message",把"消息和群组"的权限都开通。至少要开通这些:
• im:message• im:message.group_at_msg:readonly• im:message.p2p_msg:readonly• im:message:send_as_bot
如果你希望机器人能读写飞书文档和多维表格,也可以顺手都开通。
在"凭证与基础信息"这里拿到两个关键信息:App ID 和 App Secret。
第二步:启动本地程序
这一步最关键。你需要用刚才拿到的 App ID 和 App Secret 去连接飞书。
在配置文件里填入这两个信息,然后启动服务。如果配置正确,服务启动后会自动建立长连接。保持这个服务运行,别关。
如果你不太会手动配置,我建议装个 Claude Code 或者 OpenCode,让 AI 帮你配。直接跟 AI 说"帮我配置 OpenClaw 的飞书频道,配置文件是 openclaw.json",跟着提示做就行。
第三步:飞书后台保存配置
确认程序已经成功运行(终端没报错,可能显示 "connected")后,回到飞书开放平台后台:
进入应用 → "事件与回调" → 选择"使用长连接接收事件" → 保存。
然后点"添加事件",搜索并添加 im.message.receive_v1。
最后,这一步很重要:去"版本管理与发布",创建新版本并发布。只有发布后,配置才会正式生效。
配置技能和 Hooks
频道配置完后,向导会问你要不要配置 Skills。可以先跳过,后面需要再通过 openclaw configure 配置。
Hooks 建议全部启用(默认已全选):
后续可以用这些命令管理:
• openclaw hooks list— 查看所有 Hooks• openclaw hooks enable <name>— 启用• openclaw hooks disable <name>— 禁用
Gateway 服务
向导会自动安装 Gateway 服务(Linux 下是 systemd 服务),确保网关持续运行。
Web 控制面板
向导会显示 Web 控制面板地址:
Web UI: http://127.0.0.1:18789/Web UI (with token): http://127.0.0.1:18789/#token=xxxxxGateway WS: ws://127.0.0.1:18789孵化 Bot
最后一步,选择如何首次启动 Bot:
◇ How do you want to hatch your bot?│ ● Hatch in TUI (recommended)│ ○ Open the Web UI│ ○ Do this later我推荐选 Hatch in TUI,会直接进入终端聊天界面。Bot 会发送 "Wake up, my friend!" 作为第一条消息。你可以开始跟它对话,告诉它你的需求——描述越详细,后续体验越好。
退出 TUI 按 Ctrl+C 就行。Bot 的 Gateway 服务还在后台跑着。
验证飞书连接
飞书应用发布成功后,开发者小助手会发消息通知。点"打开应用",给机器人发条消息,收到回复就说明配置成功了。
如果有异常提示,别慌,把提示复制下来扔给 Claude Code,让它帮你修。
日常使用
OpenClaw 有两个核心组件:
关键点:只要 Gateway 在后台跑着,你就能通过飞书随时跟 AI 对话——不需要打开 TUI 或 Web 控制面板。
下次开机后
onboard 向导已经自动装好了 Gateway 的 systemd 服务,每次开机后会自动启动。
确认 Gateway 是否在运行:
openclaw status手动管理 Gateway
通常不需要手动操作,但排查问题时可能用到:
# 查看状态openclaw status# 手动启动openclaw gateway --force# 查看实时日志openclaw logs --follow# 安装/卸载守护进程openclaw daemon installopenclaw daemon uninstallOpenClaw 能干什么
除了 OpenClaw,现在还有 picoclaw、zeroclaw、nanobot 这些。我都试过,虽然其他 Claw 主打轻量,但总体来说还是 OpenClaw 功能最全。
那 OpenClaw 能干什么呢?
我觉得这个问题因人而异。OpenClaw 就是个工具,像住在电脑里的助手,可以操作你的电脑,也可以通过网络搜集信息。它能做什么,取决于你想干什么。
最简单的,你可以让它查天气、搜新闻、总结文章。
如果你给它权限,它可以操控电脑——帮你整理文件夹(高危操作,记得备份)、修改系统配置等等。
配合飞书云文档和多维表格,能做的事情就更多了。
最关键的是,OpenClaw 支持安装和创建技能(SKILL)。这提供了无限可能,比如用 SKILL 自动生成小红书封面、公众号图片。
最后我想说,OpenClaw 这类智能工具还不够完善,最好先找台闲置电脑,上面别放重要数据和隐私。先当玩具折腾,用熟了再慢慢扩展权限。
SKILL 也一样,别一上来就装一堆。先根据实际需要,把一两个技能打磨到能用、好用。AI 的技能不在于多,而在于稳定且符合实际需要。
怎么样?赶紧试试吧。
夜雨聆风