ReaderMX.
Python技术迷

用 OpenClaw 搭建个人AI员工：手机发消息，电脑自动执行【完整版】

P何老师约 5 分钟

很多人第一次听到 OpenClaw，会把它当成“又一个聊天机器人项目”。实际定位更接近一个自托管网关。它把 WhatsApp、Telegram、Discord、Slack、iMessage 等消息渠道接到同一个 Gateway，再把消息路由给 AI 代理去处理。你自己掌控运行环境和配置。

官方给它的目标用户很明确，偏开发者和重度用户，想要一个随时可消息触达的个人 AI 助手，同时保留数据和部署控制权。

为什么值得关注？

你现在的工作流很可能是碎片化的。群里收需求，文档里整理，工具里执行，再回到聊天工具同步结果。OpenClaw 的价值在于把入口收敛到一个 Gateway，减少跨工具反复切换。官方文档里也强调一个 Gateway 可以同时服务多个渠道和多个代理路由。

一、OpenClaw 是什么？

OpenClaw 是一个自托管的多渠道 AI 网关。你在自己的机器或服务器上运行一个 Gateway 进程，它负责会话状态、消息路由、渠道连接和控制面接入。

Image

它和普通 Bot 框架的区别在于 它把“渠道接入”和“代理执行”放到统一网关下管理，并提供控制界面、CLI、自动化等接入方式。控制客户端和节点通过 WebSocket 连到 Gateway。默认绑定地址是 127.0.0.1:18789。

二、系统架构怎么理解

用最简模型看就三层。

第一层是渠道层 WhatsApp、Telegram、Discord、Slack、iMessage 等作为消息入口。

第二层是 Gateway 层 Gateway 是单一事实源，负责会话、路由、鉴权、渠道状态。官方建议一台主机通常一个 Gateway 就够用，多 Gateway 一般只用于冗余或强隔离。

第三层是代理与工具层 Gateway 把请求路由到代理能力和工具能力，支持多代理路由和会话隔离。官方文档里把工具体系单独列出，便于扩展执行动作。

Image

三、具体应用场景

你可以把它理解为“消息驱动的自动执行层”。以下场景最容易先见效。

内容团队：在群里丢素材链接，自动做摘要、归档、打标签，再回传。这个场景对稳定性和复用价值都高。

运维和协作团队：通过统一入口触发固定动作，减少人工重复操作。渠道统一后，协作透明度更高。

个人 AI 助手：手机端发消息触发任务，浏览器控制台查看上下文和结果，适合跨设备工作流。

Image

如果你只想先验证可用性，官方提供了“先开 Control UI 聊天”的最短路径，连渠道都可以后配。

四、本地如何一步步搭建

下面是官方路径，我压成最小闭环。目标是十分钟内跑通。

第 1 步，检查 Node 版本，官方要求 Node 22 或更高。

node -v
Image

第 2 步，安装 OpenClaw，直接用官方的链接。

  • macOS 或 Linux
curl -fsSL https://openclaw.ai/install.sh | bash
  • Windows PowerShell
iwr -useb https://openclaw.ai/install.ps1 | iex

第 3 步，执行初始化向导(这个是官方推荐的傻瓜式安装)

openclaw onboard

这一步会引导你完成基础配置。

Image

第 4 步，选择模型提供方（上下箭头选择，回车确认），OpenClaw 支持多个提供方，完成认证后设置默认模型，格式是 provider/model，我这里选的 kimi 2.5 性价比还行，说实话用 claude 还是有点烧不起 token。

Image

第 5 步，要让 OpenClaw 通过 Telegram 正常收发消息，按这几步操作：

打开 Telegram；
搜索并进入 @BotFather 对话；

Image

发送 /newbot 创建机器人；
创建完成后复制返回的 Bot Token；
回到终端，把 Bot Token 粘贴到提示输入的位置。

第 6 步， 配置 Skills（按空格选择），Skills 可以理解成 OpenClaw 的“能力扩展包”，像自动发邮件、跑定时任务这类动作都靠它来加。

安装向导里会问你要不要现在启用。想一起配就选 Yes，包管理器选 npm 就行。
如果你现在只想先把基础链路跑通，直接跳过也完全没问题，后面随时可以再加。

Image

我的建议是先跑通核心功能，再按场景一点点加 Skills。

第 7 步，接下来是 API 密钥配置。OpenClaw 会问你要不要补充额外的 API Key，比如搜索能力或云端服务。

你手里有就直接填上，后续功能会更完整。
暂时没有也不用卡住，选 No 跳过即可。
先把基础聊天链路跑通，后面再补这些能力就行。

Image

第 8 步，OpenClaw 我一般就用两个入口。

Image

一个是浏览器控制台，也就是 Control UI。终端会给你一个网址，打开就能管 OpenClaw，界面直观，平时用起来省心。

Image

另一个是终端里的 TUI。直接在命令行聊天和改配置，步骤少，第一次上手用它最快。

第 9 步，Telegram 接好后就很简单了。
进你的机器人对话框，先发 /status，或者直接发一条消息，就能和 OpenClaw 聊起来。
后面它就会按助手模式接收和回复你的指令。

Image

到这里，基本上就安装完成了。

最后，还有两个我常用的命令分享给大家。

1、检查网关状态

openclaw gateway status

状态正常再进行下一步。

Image

2、 OpenClaw 的“体检加自动修复”

openclaw doctor --fix

它会做两件事。先检查配置里的错误项，比如字段名写错、类型不对、旧版本遗留配置。然后自动应用官方可修复的迁移和修正，并重写配置文件。

五、常见问题与处理思路

1、资源要求高吗？

官方 FAQ 给到个人使用参考，512MB 到 1GB 内存、1 核和约 500MB 磁盘可运行，树莓派 4 也可用。想留余量可用 2GB。

2、一定要 Docker 吗？

不一定。官方 Docker 文档写得很清楚，Docker 适合隔离和无本地安装环境。你在自己机器开发调试，普通安装流更直接，为了安全起见，我还是建议你不要用自己的本机来安装，用闲置的电脑。

3、网关放到公网要注意什么？

先配鉴权，再配反向代理信任源。官方安全页要求正确设置 trustedProxies，避免伪造来源头。

4、需要几个 Gateway？

多数场景一个就够。只有冗余或强隔离需求才考虑多 Gateway。

OpenClaw 这类项目的关键不在“功能表有多长”，在于你能否稳定跑出一个闭环。先把 Gateway 跑通，先把一个渠道接通，先把一个任务做稳。这样迭代，你很快就会从“会用工具”走到“会搭系统”。

给新手的建议，遇到问题直接查阅官方文档或者问我，也可以扫码加下方微信解决～

KEEP THE THREAD GOING

更多来源文章