OpenClaw 装机指南：从踩坑到真香

一个装过三遍、踩过十几个坑的人，把经验全写在这了。

这玩意到底是啥

先用五句话讲清楚 OpenClaw（中文社区叫"小龙虾"）是什么：

OpenClaw 是一个开源的自托管 AI 助手框架，由奥地利开发者 Peter Steinberger 创建，MIT 协议完全免费。它不是又一个聊天机器人 -- 它能连接你的飞书、Telegram、钉钉等消息平台，调用各种 Skills 插件帮你真正干活：管文件、跑脚本、读邮件、爬网页、定时任务，7x24 小时在线。GitHub 上 250K+ stars（截至 2026 年 3 月初），比 React 还多。2026 年 2 月创始人加入了 OpenAI，项目转交开源基金会运营，社区活跃度拉满。

一句话总结：把大模型的能力，从"对话框"搬到了"工作台"。

好，废话结束，直接开干。

第一步：选一个适合你的安装方式

安装方式有四种，但不是每种都适合你。我帮你做个判断：

我的建议：如果你只是想先试试水，npm 安装最省事。如果你确定要长期用，上一台云服务器，68 块钱一年的阿里云轻量服务器完全够用。

第二步：动手安装

方式 A：npm 安装（推荐大多数人）

前提条件：Node.js 24（推荐）或 22.16+。如果你不确定版本：

node-v
# 如果低于 v22.16，先用 nvm 升级
nvminstall24
nvmuse24

然后三条命令：

npminstall-gopenclaw
openclawonboard# 交互式引导，跟着走就行
openclaw# 启动

openclaw onboard 会问你用什么模型、接什么平台，选就完了。引导完成后终端会输出一个带 token 的访问链接，格式类似：

http://127.0.0.1:18789?token=xxxxxxxxxxxx

把这个链接复制到浏览器打开，你的小龙虾就活了。注意默认绑定的是 127.0.0.1，不是 localhost，直接用终端输出的完整链接最稳妥。

国内用户注意：npm 默认源在国内很慢，先换镜像：

npmconfig set registryhttps://registry.npmmirror.com

这一步不做，大概率安装超时。我第一次装的时候就卡在这儿等了半天，最后超时报错，换了镜像秒装完。

方式 B：Windows 一键安装

GitHub 上有个社区项目 OpenClawInstaller（github.com/miaoxworld/OpenClawInstaller），下载后双击运行，自动帮你装 Node.js 和 OpenClaw。适合不想碰命令行的 Windows 用户，但缺点是更新不够及时，可能不是最新版。

方式 C：云服务器部署

如果你要 24 小时在线服务，云服务器是正道。阿里云和腾讯云都有预装镜像，买完直接用。手动装也不复杂：

# SSH 登录服务器后
npminstall-gopenclaw@latest
openclawonboard--install-daemon# 关键：装成守护进程

加了 --install-daemon 后，SSH 断开连接 OpenClaw 也不会挂掉。没加这个参数是最常见的云服务器部署失误 -- 你一关终端，小龙虾就跟着走了。

方式 D：Docker

dockerrun-d--nameopenclaw\
-p18789:18789\
-vopenclaw-data:/home/node/.openclaw\
ghcr.io/openclaw/openclaw:latest

简洁，但如果你后续要装一些需要系统级依赖的 Skills（比如 Playwright 浏览器操作），在容器里折腾起来会比较痛苦。纯对话场景用 Docker 没问题，重度使用建议直接装在系统上。

第三步：选模型、配 API

这一步决定了你的小龙虾"聪不聪明"。openclaw onboard 过程中会引导你选模型，也可以后续手动编辑配置文件 ~/.openclaw/openclaw.json（Windows 下为 %USERPROFILE%\.openclaw\openclaw.json）。

模型怎么选？我的推荐策略

注：以上费用为个人轻度使用的参考范围，实际因用量差异较大。

我的实战策略：日常用 DeepSeek，重要任务切 Claude。 DeepSeek 处理日程管理、文件整理、信息汇总这些日常任务绰绰有余，但遇到复杂的代码审查或长文档分析时，Claude 的效果明显更好。我实测下来这个搭配每月花费大概 20-40 元，比纯用 Claude 省了 80%，但体验只下降了一点点。

DeepSeek 配置示例

去 platform.deepseek.com 注册，充 10 块钱够用好一阵。拿到 API Key 后，编辑 ~/.openclaw/openclaw.json：

{
"env": {
"DEEPSEEK_API_KEY": "sk-你的key"
  },
"agents": {
"defaults": {
"model": {
"primary": "deepseek/deepseek-chat"
      }
    }
  }
}

API Key 通过 env 字段传入，模型在 agents.defaults.model 里指定，格式为 provider/model-name。这个嵌套结构第一次看可能不习惯，但习惯了会发现很灵活 -- 你可以给不同 Agent 配不同模型。

Ollama 本地模型配置

想完全免费、数据不出本机？装 Ollama（ollama.com），然后：

ollamapullqwen2.5:14b# 中文推荐 Qwen 系列

OpenClaw 配置里把模型改成 ollama/qwen2.5:14b，它会自动连接本地 http://localhost:11434。注意：如果你修改过 Ollama 的默认端口，需要在配置中对应调整。本地模型对硬件要求不低，14B 参数的模型建议 16GB 以上内存，有独显更好。没有好显卡硬跑，响应会慢到让你怀疑人生。

第四步：接入消息平台

光在网页上用 OpenClaw 其实没发挥它的核心价值 -- 它的杀手锏是嵌入你日常使用的通讯工具。

飞书（推荐，最丝滑）

飞书是接入体验最好的平台，没有之一。2026 年初飞书官方已经内置了 OpenClaw 插件。

不过飞书的接入需要完成一个配对授权流程（pairing）：在飞书开放平台创建自建应用，然后在 OpenClaw 端发起配对，飞书端确认授权。实际步骤涉及应用权限配置、事件订阅等，比"填个密钥就完事"要复杂一些，建议跟着官方文档一步步来。

我第一次接飞书花了快 20 分钟，主要卡在应用权限那一步——少勾了一个"接收消息"权限，导致机器人死活收不到消息，排查了半天。第二次就 5 分钟搞定了。 接入后在飞书里 @ 你的机器人就能直接对话，群聊私聊都支持。

Telegram（海外用户首选）

去 Telegram 找 @BotFather，发 /newbot 创建机器人，拿到 Bot Token 后：

openclawchannelsadd--channeltelegram--token<你的Bot-Token>

Telegram 的优势是原生支持，零成本，消息格式支持也最好。

微信（能接，但要慎重）

微信没有官方开放接口，OpenClaw 接入微信走的是第三方逆向桥接。说白了就是模拟微信客户端登录。

我必须把丑话说在前面：这有封号风险。 微信对第三方客户端的检测越来越严，虽然社区里很多人在用，但我个人不建议拿主力微信号去接。如果你一定要试，用小号。

十个实战场景：装完之后能干啥

装好了、配好了，然后呢？下面是我实际用下来频率最高的场景，按"上手难度"从低到高排列。

场景 1：日常问答和头脑风暴

最基础的用法——在飞书/Telegram 里直接 @ 小龙虾提问。比 ChatGPT 网页版方便的地方在于：不用切 App，在工作流里直接对话。写周报卡壳了让它帮你列提纲，开会前让它帮你整理议题，随手就来。

场景 2：自然语言管理服务器

在飞书里发一句："帮我看看服务器磁盘还剩多少空间"，OpenClaw 通过 Shell Skill 运行 df -h，把结果格式化后回复你。出差在外用手机管服务器，比 SSH 客户端方便太多。 我现在重启服务、查日志、看进程全在飞书里搞定。

openclawskillsinstallshell-executor

场景 3：定时信息汇总

配置 RSS 订阅 + 定时任务，让 OpenClaw 每天早上 8 点把你关注的技术博客、新闻源做一份摘要推送到飞书。我订了 10 来个源，以前每天刷资讯要半小时，现在 5 分钟看完摘要就够了。

场景 4：文件批量处理

"把 Downloads 文件夹里所有 PDF 按日期重命名并归类到对应月份文件夹" —— 这种用 Shell 脚本写起来不难但很烦的活，自然语言说一句就搞定。我还经常让它批量转换图片格式、压缩文件、清理临时目录。

场景 5：邮件管理

接入 Gmail/Outlook 后，你可以说"帮我看看今天有没有重要邮件"，它会帮你筛选、摘要、甚至草拟回复。对邮件焦虑症患者是福音。 我设了个规则：每天早上自动摘要未读邮件推送到飞书，重要的标红提醒。

场景 6：代码审查助手

接入 Git 仓库后，提 PR 时自动做一轮代码审查。我在团队里试了一个月，它不能替代人工 review，但能提前抓出 60%-70% 的低级问题（命名不规范、未处理异常、明显的逻辑错误），人工审查的压力小了很多。

场景 7：日程和待办管理

接入 Google Calendar 或 Outlook Calendar 后，"帮我明天下午 3 点加一个需求评审会，拉上张三李四" 就能搞定。也可以每天早上让它推送今日日程提醒。比手动打开日历 App 操作快多了。

场景 8：翻译和文档处理

扔给它一份英文技术文档，"翻译成中文，保留代码块和格式"。比 Google 翻译好的地方在于它能理解技术术语，不会把 "container" 翻成"容器"又翻成"集装箱"。我还经常让它帮忙润色技术方案文档。

场景 9：网页自动化

装上 Playwright 浏览器 Skill，OpenClaw 能帮你自动填表、抓数据、截网页。我用它定期抓竞品官网的价格变动，省了写爬虫的功夫。注意：需要额外安装浏览器内核：

openclawskillsinstallbrowser-automation
npxplaywrightinstallchromium

场景 10：自动化运维告警

配合 cron 定时任务和 Shell Skill，你可以让 OpenClaw 每 5 分钟检查一次服务健康状态，异常时自动推送告警到飞书群。比起专门搭一套 Prometheus + AlertManager，对小团队来说这个方案够用且零成本。

踩坑大全：我替你踩过的 12 个坑

这是全文最值得收藏的部分。

三条安全红线，必须知道

第一，限制 Shell 权限。 OpenClaw 装了 Shell 执行 Skill 后，理论上能在你机器上运行任何命令。我有一次随口让它"清理一下临时文件"，差点误删了工作目录。生产环境务必开启 sandbox 模式，限制可执行的命令范围。Skills 权限过大是最容易被忽视的安全隐患。

第二，认准官方仓库。 GitHub 上已经出现过冒充 OpenClaw 的钓鱼项目，有的甚至借"CLAW 代币"搞诈骗。值得一提的是，这个项目经历过三次更名（最早叫 ClawAssistant，后来改名 OpenClaw-AI，最终定名 OpenClaw），搜索时注意辨别新旧名称的仓库。唯一官方地址：github.com/openclaw/openclaw。其他带 token、coin 字样的都是假的。

第三，微信接入要用小号。 前面说过了，微信桥接走的是非官方接口，封号风险真实存在。绝对不要拿你的主力微信号去做实验。

写在最后

OpenClaw 是我今年用过的最有"实感"的 AI 工具。不是那种"wow 好厉害"然后关掉再也不打开的 demo，而是真的能融入日常工作流的东西。DeepSeek 充 10 块钱、配个飞书，你就有了一个 24 小时在线的 AI 助手 -- 这在一年前还是需要花大几千块买 SaaS 服务才能实现的事。

当然它也不完美：本地模型吃硬件、微信接入有风险、Skills 生态质量参差不齐。但作为一个开源项目，它的完成度已经相当惊人了。

建议你今晚花 30 分钟装一个试试。大不了卸了，反正不要钱。

你准备把小龙虾接入哪个平台？飞书、Telegram、还是冒险试试微信？欢迎留言聊聊你的选择和踩坑经历。