范叶亮写智能体、模型和数据系统时,习惯先把定义和边界钉死。把「本地部署智能体」整理成可落地的中文笔记:问题在哪、默认做法会踩什么坑、该怎么选。原站导航和广告已去掉。
安装
本教程将介绍在 macOS 环境下部署 OpenClaw,QwenPaw 和 Hermes Agent。如无特殊说明,macOS 系统下需在终端中执行命令,Windows 系统下需要在 PowerShell 中执行命令。本教程涉及到的软件信息如下:
scoop install podman scoop 安装请参见: https://scoop.sh/
消息频道
brew install podman-desktop Windows scoop install podman-desktop 安装完毕后,运行如下命令初始化并启动 Podman:
podman machine init podman machine start Windows podman machine init podman machine start 运行如下命令查看 Podman 的安装和运行情况:
飞书
podman info Windows podman info 更多 Podman 使用方法请参考 Podman 文档 。有关 Podman Desktop 的使用方法请参考 Podman Desktop 文档 。
git clone git@github.com:openclaw/openclaw.git Windows git clone git @github . com : openclaw / openclaw . git macOS 运行如下命令安装 OpenClaw CLI:
Discord
curl -fsSL https://openclaw.ai/install-cli.sh | bash 命令会在 ~/.openclaw 目录下安装 Node 环境和相关依赖。进入 OpenClaw 源代码目录下,运行如下命令构建 Gateway 容器:
export OPENCLAW_DOCKER_APT_PACKAGES = "chromium" ./scripts/podman/setup.sh 其中 OPENCLAW_DOCKER_APT_PACKAGES 表示构建 Gateway 容器时使用 apt 命令额外安装的软件包。运行如下命令启动 Gateway 容器:
安装
./scripts/run-openclaw-podman.sh launch 运行如下命令进行配置:
./scripts/run-openclaw-podman.sh launch setup 在配置过程中根据实际情况对模型提供商等选项进行配置。配置如下环境变量来使用宿主机中的 OpenClaw CLI 管理 OpenClaw 容器:
消息频道
export PATH = " $PATH :/Users/leo/.openclaw/bin" export OPENCLAW_CONTAINER = openclaw Windows 在合适的目录创建如下文件夹:
mkdir / path / to / openclaw mkdir / path / to / openclaw / workspace 进入 OpenClaw 源代码目录下,运行如下命令构建 Gateway 容器:
落地时建议先做的 5 件事
- 先写清任务能不能被自动验证:能验证的交给系统和评测,不能验证的留给人审。
- 本地部署先算显存、延迟和失败回滚,不要只看能跑通一次。
- 多智能体只在单智能体触到上下文或专业边界时再拆。
- Token、微调和压缩都要有对照数字,避免口号式优化。
- 结论写成可检查清单:接口、超时、评测集、回滚版本。
和智能体产品怎么接
龙虾PRO做 OpenClaw 落地时,最该拿走的是「单智能体先做好工具和提示,再谈编排」。数字员工、技能市场和网关应共用同一套评测与权限,而不是各写一套角色人设。
本文侧重智能体生命周期与技能边界。若你要动手验证,优先用 Playground 做小任务压测;权限与托管再单独规划,避免「先装一堆再治理」。 相关:Playground · 创建智能体 · 学习中心
常见问题 FAQ
什么是本地部署智能体?
「本地部署智能体」可概括为:本教程将介绍在 macOS 环境下部署 OpenClaw,QwenPaw 和 Hermes Agent。如无特殊说明,macOS 系统下需在终端中执行命令,Windows 系统下需要在 PowerShell 中执行命令。本教程涉及到的软件信息如下: 本文从定义、方法与实践要点展开说明。
为什么要关注本地部署智能体?
关注本地部署智能体,是因为它直接影响效率、风险与可复制性。文中指出:本教程将介绍在 macOS 环境下部署 OpenClaw,QwenPaw 和 Hermes Agent。如无特殊说明,macOS 系统下需在终端中执行命令,Windows 系统下需要在 PowerShell 中执行命令。本教程涉及到的软件信息如下:
如何落地本地部署智能体?有哪些关键步骤?
建议按以下路径推进本地部署智能体:1) 先写清任务能不能被自动验证:能验证的交给系统和评测,不能验证的留给人审。;2) 本地部署先算显存、延迟和失败回滚,不要只看能跑通一次。;3) 多智能体只在单智能体触到上下文或专业边界时再拆。;4) Token、微调和压缩都要有对照数字,避免口号式优化。;5) 结论写成可检查清单:接口、超时、评测集、回滚版本。。细节见正文对应章节。
本地部署智能体适合哪些人或团队?
本地部署智能体更适合:产品/技术负责人、运营与增长团队、需要落地智能体或自动化的中小团队、关注「AI智能系统」方向的读者。若你只需要单次聊天式问答,可先读概念;若要上生产,请重点看步骤、权限与风控相关段落。
关于「安装」,本文给出了什么结论?
在「安装」部分,要点是:s://scoop.sh/ 消息频道 brew install podman-desktop Windows scoop install podman-desktop 安装完毕后,运行如下命令初始化并启动 Podman: podman machine init podman machine start Windows podman machine init podman machine start 运行如下命令查看 Podman 的安装
关于「消息频道」,本文给出了什么结论?
在「消息频道」部分,要点是:dman Desktop 文档 。 git clone git@github.com:openclaw/openclaw.git Windows git clone git @github . com : openclaw / openclaw . git macOS 运行如下命令安装 OpenClaw CLI: Discord curl -fsSL https://openclaw.ai/install-cli.sh | bash 命