OpenClaw 完整部署指南:从0到1搭建你的AI机器人

不少朋友在问如何部署 OpenClaw（俗称“龙虾”）以及接入第三方 API。为了帮大家避坑，我把这套部署流程的核心关键步骤和容易出问题的地方都梳理了出来。这是一份专门为准备使用 OpenClaw 的朋友准备的实战指南，整个过程可以归纳为 6 个核心步骤，跟着做，新手也能一次跑通。

部署环境选择

在正式开始之前，先了解一下 OpenClaw 可以部署在哪些环境中，以及各种方案的优缺点，帮助你选择最适合自己的部署方式。

方案一：主力工作机（⚠️ 不推荐）

虽然技术上可行，但强烈不建议在个人主力电脑上直接全局部署：

• 权限风险过高：OpenClaw 拥有执行系统命令、读写文件的完整能力。一旦配置不当或遇到恶意的第三方插件，可能误删重要文件、泄露敏感数据。

总结：除非你清楚了解所有风险并做好隔离措施，否则不要在存有重要数据的主力机上部署。

方案二：云服务器（⚠️ 不值得特意购买服务器）

最传统也最稳定的部署方案：

优点：

• 7×24 小时在线，无需担心关机导致机器人离线
• 系统环境干净，与本地工作完全隔离

缺点：

• 需要额外租用服务器，基础配置（建议至少 2核2G，以便完成基础任务）约 28-300 元/年
• 对于只是尝鲜体验的用户来说成本偏高

适用人群：有长期具体使用需求、希望机器人稳定在线、有一定预算的用户或者企业使用。

方案三：Mac（⭐ 仅适合有闲置 Mac 设备的用户）

如果有闲置的 Mac 设备，这是目前体验最好的物理隔离方案：

• 权限可控：专门用于跑机器人，不存放重要数据，即使出问题也不会影响主力工作。
• 随时在线：只要将 Mac 放在有网络连接的地方，并一直插电运行（建议配合防休眠软件如 Amphetamine），就可以确保机器人随时在线响应。
• 零额外成本：充分利用闲置设备，不需要每月花钱租用云服务器。

为什么选择 macOS 备用机（杀手级优势）：

• 开箱即用的 GUI 与 Computer Use 能力：最新的 AI 模型拥有强大的 Computer Use（电脑操控）能力，可以模拟真人去查看屏幕、移动鼠标、操作浏览器或桌面软件。但在常规的 Docker 容器或轻量虚拟机中，系统往往是没有图形界面的（Headless），配置虚拟桌面极其繁琐。而闲置的 Mac 天生自带完整的图形系统，只需授予屏幕录制和辅助功能权限，它就能直接化身拥有物理电脑操作权的“数字员工”，这也是它碾压容器方案的最大亮点。
• 快捷指令 (Shortcuts) 联动：macOS 的“快捷指令”支持通过终端命令行触发（shortcuts run）。这意味着 OpenClaw 可以通过一行命令，直接调用你系统里的日历、提醒事项，甚至控制 HomeKit 智能家居。
• Homebrew 生态：利用 Mac 强大的包管理器 Homebrew，OpenClaw 需要用到任何外部工具（如处理视频的 ffmpeg、处理文档的 pandoc）时，都可以极其丝滑地一键安装调用。
• 生态无缝同步：同一个 Apple ID 下，你可以让 OpenClaw 把处理好的文件直接保存在 iCloud Drive 专属文件夹里，你的主力机甚至手机瞬间就能无缝同步查看，体验极佳。

替代方案：闲置的 Windows 笔记本（需开启 WSL 安装 Linux 子系统）、树莓派、NAS 等低功耗设备都可以。

总结：这是个人用户性价比最高的选择——既保证了稳定性，又天生解锁了极具潜力的 GUI（图形界面）操控能力，还不需要额外花钱。

方案四：主力机虚拟机或 Docker（折中方案）

想在主力机上使用，但又担心安全问题？可以考虑虚拟化隔离：

虚拟机方案：

• 使用 VMware、Parallels 或 VirtualBox 创建一个隔离的 Linux 虚拟机。
• 优点：完全隔离，不影响主机系统。
• 缺点：需要分配一定内存（建议 2G 以上），虚拟机开机时机器才能在线。

Docker 方案：

• 在 Docker 容器中运行 OpenClaw。
• 优点：资源占用低，启动快速。
• 缺点：容器网络配置较复杂，数据持久化需要挂载卷。

实际案例参考：

这是我目前正在使用的方案，配置如下：

【硬件与环境】

• 主机：MacBook Pro（主力工作机）
• 虚拟化：OrbStack（比 Docker Desktop 更轻量的 macOS 容器方案）
• 容器系统：Debian 13
• 防休眠：Amphetamine（macOS 防休眠工具，保持 Mac 始终运行）

【方案优势】

• 完全隔离：OpenClaw 运行在 Debian 容器中，与 macOS 主机完全隔离，不存在越权风险。
• 随时在线：通过 Amphetamine 保持 MacBook 不休眠，无论在公司还是家里，只要有网络连接，机器人就能 7×24 小时运行。
• 资源占用低：OrbStack 比传统虚拟机轻量得多，对日常工作几乎无影响。
• 访问便利：需要调试时，直接通过 OrbStack 的 Terminal 终端界面或 Files 文件管理界面访问容器即可，非常直观。

【配置要点】

1. 在 OrbStack 中创建 Debian 13 容器，分配 2G 内存即可流畅运行。
2. 容器网络模式选择默认的共享网络，无需额外配置端口映射。
3. 安装 Amphetamine 并设置「永不休眠」规则，确保 MacBook 合盖后依然运行。
4. 在 Debian 容器中按照本文「环境准备」后的步骤正常安装 OpenClaw。

这个方案结合了安全隔离和持续在线的优点，是主力机用户的理想选择。

环境准备

开始前请确保以下条件已满足：

• 容器（闲置电脑、虚拟机）
• Git 已安装
• Node.js v22 或更高版本
• 准备一个作为机器人的通讯账号（见第二步指引）

硬件资源配置建议

说明：

• OpenClaw 本身资源占用很低，主要消耗取决于大模型和本地运行的插件。
• 容器/虚拟机部署时，给 Debian 容器分配 2GB-4GB 内存即可流畅运行。

第一步：安全安装 OpenClaw

推荐使用 Node 版本管理器在用户空间安装，这是一种既安全又不容易产生权限冲突的做法。

推荐安装方式（使用 nvm）：

# 1. 安装 nvm（如未安装）curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bashsource ~/.bashrc# 2. 安装 Node.js v22nvm install 22nvm use 22# 3. 在普通用户权限下安装 OpenClawnpm install -g openclaw

替代方案（使用 fnm）：

# 安装 fnm（如未安装）curl -fsSL https://fnm.vercel.app/install | bash# 安装 Node.js v22 并启用fnm use --install-if-missing 22# 安装 OpenClawnpm install -g openclaw

当看到安装成功的提示信息时，说明核心程序已经就位。

【终端输出示例】

added 1 package in 3sopenclaw@x.x.x installed globally

第二步：创建机器人（Telegram / 飞书）

这里建议大家根据自己的网络情况选择二选一的通讯渠道方案：

• 具备科学上网条件的用户：推荐使用 Telegram，配置简单，无 API 限制。
• 国内网络环境用户：强烈推荐使用 飞书，访问稳定，且生态极其完善。（请直接跳至下方的“飞书用户接入指南”）。

Telegram 用户配置指南

打开 Telegram 应用，搜索 @BotFather（认准蓝色对勾官方认证标识），按以下流程操作：

1. 发送指令 /newbot 给 BotFather
2. 根据提示设置机器人的显示名称
3. 设置机器人的唯一用户名（必须以 bot 结尾，例如 myhelper_bot）
4. 创建成功后，BotFather 会返回一段 Bot Token（格式如：123456789:ABCdefGHIjkl……），请务必妥善保存。

安全提醒：Bot Token 相当于机器人的最高权限密钥，切勿在公开场合泄露。如果不慎泄露，可在 BotFather 中发送 /revoke 重新生成。

飞书用户接入指南

飞书开放平台对个人开发者非常友好，几分钟就能跑起来。

1. 创建飞书应用并获取凭证

• 访问飞书开放平台：https://open.feishu.cn/app
• 登录后点击「创建企业自建应用」，填写名称（如 “OpenClaw 助手”）。
• 进入应用详情页，在左侧「凭证与基础信息」中记录 App ID 和 App Secret，妥善保存。

2. 配置飞书权限与事件

• 左侧菜单选择「机器人」，打开「启用机器人」开关。

• 左侧菜单选择「权限管理」，搜索并添加以下权限：

• im:message:send（发送消息）

• im:message:receive（接收消息）

• im:chat:readonly（获取群组信息）

• im:resource（获取图片等资源）

• 在「版本管理与发布」中，创建新版本并申请线上发布（自己审批通过即可）。

第三步：运行配置向导与 Hooks 详解

在终端输入以下命令启动交互式配置向导，向导会自动帮你完成渠道绑定和 Hooks 的初始化：

openclaw onboard

向导会逐步询问配置选项，建议按以下方式选择：

(注：如果你选择了飞书，向导完成后，你需要回到飞书开放平台的「事件订阅」页面，在「请求地址」中填入 http://你的服务器IP:18790/feishu/webhook，并添加 im.message.receive_v1 事件订阅即可。)

💡 Hooks 全选详解（扩展能力）

在向导中我们选择了开启全部 Hooks，系统会自动在后台完成装载，以下是它们为你赋予的强大能力：

第四步：配置 botcode 模型

向导生成的配置文件中没有模型配置（因为刚才选择了 Skip）。现在需要手动将 botcode 的模型信息添加进去。

编辑配置文件：

nano ~/.openclaw/openclaw.json

在文件最外层的大括号内，找到合适的位置（通常在 meta 块之后），插入以下配置（注意替换为你的真实 API Key）：

"models": {  "providers": {    "botcode": {      "baseUrl": "https://botcode.top",      "apiKey": "sk-这里填你的botcode的APIKey",      "api": "anthropic-messages",      "models": [        {          "id": "claude-opus-4-6",          "name": "Claude Opus 4.6 (botcode)",          "thinking": { "type": "adaptive" },          "input": [ "text", "image" ],          "contextWindow": 200000,          "maxTokens": 128000        },        {          "id": "claude-sonnet-4-6",          "name": "Claude Sonnet 4.6 (botcode)",          "thinking": { "type": "adaptive" },          "input": [ "text", "image" ],          "contextWindow": 200000,          "maxTokens": 64000        }      ]    }  }},"agents": {  "defaults": {    "model": {      "primary": "botcode/claude-sonnet-4-6"    }  }}

⚠️ 重要提示：如果配置文件中已存在 agents 字段，需要将 model 字段合并到现有的 agents 中，而不是创建一个新的 agents 块。JSON 同一层级不能有两个同名 key，否则后一个会覆盖前一个，导致配置丢失。

关于 api 字段的说明：

• anthropic-messages：适用于 Claude 系列模型（如 Opus 4.6、Sonnet 4.6 等）。
• openai-responses：适用于 GPT 系列模型及兼容 OpenAI 格式的开源模型。

根据你在 botcode 上实际使用的模型类型选择对应的 api 格式。保存并退出编辑器。

第五步：重启服务

配置文件修改后需要重启 OpenClaw 服务才能生效：

openclaw gateway restart

重启完成后，可用以下命令检查服务状态：

openclaw gateway status

只要状态显示为 active (running) 就没问题，可以继续进行下一步配对操作。

第六步：身份配对

服务重启成功后，打开 Telegram（或飞书）给你的机器人发送任意消息（如“你好”）。机器人会回复一段配对信息，类似以下内容：

【机器人回复示例】

OpenClaw: access not configured. Your Telegram user id: 123456789Pairing code: ABCD1234

这是正常现象，说明还需要完成最后一步的身份绑定。复制最后一行的配对码（如 ABCD1234），回到服务器终端执行（如果你用的是飞书，把 telegram 换成 feishu）：

openclaw pairing approve telegram ABCD1234

看到 Approved 提示后，回到聊天软件再次发送消息，机器人就能正常回复了。至此部署全部完成！

流程总结

整个部署流程可分为 6 个步骤：

1. 安装程序 — 使用 nvm 安全安装 OpenClaw。
2. 准备渠道 — 获取 Telegram Token 或配置飞书应用凭证。
3. 运行向导 — 执行 onboard 命令，直接绑定通信渠道并全选 Hooks。
4. 修改配置 — 手动添加支持 4.6 自适应思考特性的模型参数。
5. 重启服务 — 使配置修改生效。
6. 身份配对 — 完成你与机器人的绑定认证。

常见问题排查

OpenClaw 能做什么？日常应用场景

OpenClaw 不仅仅是一个聊天机器人，它是一个能真正接管你工作流的 AI 助手。以下是高频使用场景：

1. 深度代码开发助手

• 项目级赋能：在系统内安装 Claude Code 或 Codex，并授予 OpenClaw 你的 GitHub 仓库权限，让它直接参与功能开发、PR 审计和自动化测试。
• 代码审查与重构：粘贴代码片段，让 AI 结合当前项目的 boot.md 规范帮你找 Bug、优化性能。

2. 文件处理与数据分析

• 超长文档解析：配合 200k 的上下文，直接扔进大型 PDF 财报或技术手册，让其提取关键节点。
• 数据自动化：利用原生代码执行能力，上传包含杂乱数据的 CSV 文件，让 AI 编写清洗脚本并直接输出可视化图表。

3. 日常生活与自动化信息流

• 私人简报：每天定时推送所在城市的天气预报和穿衣指南。
• 情报抓取：利用 Web Search 技能，定时抓取指定新闻网站或论坛的帖子，整理成摘要推送到你的飞书/TG。
• 批量操作：配合原生 Skills，批量重命名本地文件、压缩图片。

进阶玩法：全球硬核极客的真实案例

当你熟悉了基础操作，OpenClaw 的潜力是无限的。这不是画大饼，目前在 X 和各大开发者社区，全球的极客们已经把它玩出了让人惊叹的工程化高度。以下是几个真正落地的硬核案例：

1. 丢给它一个需求，一觉醒来全栈产品上线了

出处：X 平台极客分享简介：这是近期推特上极度火爆的一个真实案例。开发者 @elvissun 仅仅给 OpenClaw 提供了一句话的需求描述和服务器权限，龙虾便完全自主地完成了：搭建 Next.js 脚手架、编写前后端代码、连接数据库、生成营销文案，并最终自动部署上线。它不仅是“写代码”，而是真正具备了“全栈工程师+运维”的闭环工程能力。参考链接：https://x.com/elvissun/status/2025920521871716562

2. 24 小时全天候的“赛博分身”与私人管家

出处：独立开发者社区应用简介：有玩家将 OpenClaw 与自己的日程表、通讯软件及 Notion 深度绑定，打造了一个 24 小时在线的私人管家。它能监控消息流，自动拦截并回复非紧急的客户询问，根据主人的空闲时间自动与客户预约会议，并在每天早晚生成一份“今日简报”。相当于零成本雇佣了一个永不疲倦的高级数字助理。

3. 零干预的自动化客服与邮件中枢

出处：海外 SaaS 开发者实战简介：一位独立黑客利用 OpenClaw 挂载了 Gmail MCP 插件，让它完全接管了产品的客服邮箱。当用户发邮件要求退款或报 Bug 时，龙虾会自动读取邮件内容、通过 MCP 直连数据库确认用户的订阅身份和退款规则，然后自动生成带有专业语气的回复邮件，并在后台创建一条工单记录。整个流程 100% 自动化，无需人工干预。

这就是 OpenClaw 的魅力所在：它不仅懂你，还能真切地触达并改变你的数字世界。