clawdbot 部署全指南:3 步在 5 类设备上跑起你的个人 AI 助手
2026/8/28 10:52:08 网站建设 项目流程

clawdbot 部署全指南:3 步在 5 类设备上跑起你的个人 AI 助手

【免费下载链接】openclawYour own personal AI assistant. Any OS. Any Platform. The lobster way. 🦞项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw

clawdbot 部署并不复杂:在一台常开设备上装好本地 Gateway(网关),接上你已有的 AI 模型,然后就可以从浏览器、终端或手机上和它对话。clawdbot 是一个自托管的个人 AI 助手,核心是一个本地 Gateway,负责会话、工具调用和消息渠道的连接,桌面与移动端的 App 都只是它的"客户端"。本文按实际操作的顺序带你完成 clawdbot 安装,并给出跨设备选型的建议。

哪些设备能跑 clawdbot,先选对起点

先分清两种角色,选型就不纠结了:

  • 主机(Gateway 宿主):真正跑助手逻辑的机器,需要能常驻运行。macOS、Linux、Windows 都支持。如果只打算在一台电脑上用,选你天天开机的这台。
  • 伴随设备(Node/Companion):手机和平板上的 clawdbot 应用不运行 Gateway,它们通过网络连接主机,提供聊天、语音、相机、屏幕等本机能力。

一句话建议:先在桌面装一台 Gateway 并跑通对话,再谈把手机接进来。反过来从手机装起,会因为缺少 Gateway 而卡住。

桌面三步跑起来:macOS、Linux、Windows 通用

三种系统的核心流程完全一致,差异只在最后一点,下面分开标注。

第 1 步:安装。安装脚本会自动检测系统、补齐 Node.js 运行时并拉起引导向导:

curl -fsSL https://openclaw.ai/install.sh | bash

Windows 用户在 PowerShell 里跑对应的.ps1版本即可;更省事的方式是直接使用原生Windows Hub桌面应用,它在首次启动时会自动帮你配置一个本地 Gateway,全程不碰终端。macOS 用户除了脚本外,也可以直接下载 DMG 安装菜单栏应用,两者二选一。

第 2 步:完成引导向导(onboarding)。脚本装完会自动打开向导,跟着走完只需几分钟:选择模型提供商、填入 API Key、配置 Gateway。可选的渠道、技能步骤可以先跳过,之后用openclaw configure随时补。

第 3 步:验证。两条命令确认状态:

openclaw gateway status openclaw dashboard

第一条应显示 Gateway 在 18789 端口监听;第二条直接在浏览器打开控制台页面,能看到页面就代表链路通了。

平台差异提示:macOS 首次启动会弹出本地网络与权限确认,按系统提示逐项允许即可,见 macOS 平台文档。

移动端最快上手:让手机成为 clawdbot 的伴随节点

移动端 App 的定位是"伴随节点",前提是桌面 Gateway 已经跑起来。

  • Android:从 Google Play 安装官方 App,或在发行版页面下载签名 APK 侧载。装好后在 App 里输入 Gateway 地址完成配对,即可使用聊天、语音等能力。注意 Android 端不托管 Gateway,别指望它单机运行。
  • iOS:通过 TestFlight 或正式渠道安装 App,配对流程与 Android 一致,支持语音、设备动作等本机能力。

配对成功后,手机端和网页控制台看到的是同一套会话,消息互通,不需要各配一遍。

上手体验与进阶玩法:从第一次对话到插件扩展

跑通安装只是开始,下面按使用深度排个序。

先发消息。在控制台页面直接输入一句话,收到 AI 回复即代表模型、工具、会话链路全部正常。这是判断部署是否成功的唯一标准。

再接一个消息渠道。想让助手出现在常用聊天软件里,Telegram 是最快的(只需一个 bot token),WhatsApp、Slack、Discord、iMessage 等也在支持列表里,入口见 渠道文档。未识别的私聊发送者默认会走配对审批,用openclaw pairing approve放行即可,这算一道安全门。

然后扩展能力。助手的"手脚"来自工具、技能与插件三个层面:

  • 终端操作:openclawCLI 覆盖了日常全部管理动作,示例可见 CLI 参考;
  • 技能:skills/ 目录里有一批现成脚本型技能,放进来即可被调用;
  • 插件:extensions/ 收录了上百个按厂商、渠道、工具划分的插件,按需启用。

想进一步把它接进智能家居、日历、监控这类场景,社区 Showcase 里有大量真实案例可参考。

出问题先看这 4 条,再找官方求助

按命中率排序:

  1. 命令跑不起来:先看 Node 版本,要求 22.22.3+ / 24.15+ / 25.9+,推荐 26。
  2. Gateway 状态异常:跑openclaw doctor,它会直接列出配置问题;再用openclaw gateway status复查监听端口。
  3. 手机连不上:确认两台设备在同一网络,或检查主机防火墙是否放行了 18789 端口;对外暴露 Gateway 前先读 安全指南,默认不要公网直连。
  4. 装错渠道导致更新冲突:Android 的 Play 版与 APK 版签名体系不同,建议固定一条更新渠道。

以上都解决不了时,完整文档在 docs/,安装相关的细分方案(Docker、Nix、各云平台)都在 docs/install/ 下;确认是缺陷后到仓库提 issue,安全类问题按 SECURITY.md 的流程单独报告。

clawdbot 部署到这一步,桌面和手机已经各就各位——剩下的,就是给它接上更多你常用的渠道,让它出现在你每天聊天的地方。

【免费下载链接】openclawYour own personal AI assistant. Any OS. Any Platform. The lobster way. 🦞项目地址: https://gitcode.com/GitHub_Trending/cl/openclaw

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询