范叶亮写智能体、模型和数据系统时,习惯先把定义和边界钉死。把「本地部署智能体」整理成可落地的中文笔记:问题在哪、默认做法会踩什么坑、该怎么选。原站导航和广告已去掉。

安装

本教程将介绍在 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 件事

  1. 先写清任务能不能被自动验证:能验证的交给系统和评测,不能验证的留给人审。
  2. 本地部署先算显存、延迟和失败回滚,不要只看能跑通一次。
  3. 多智能体只在单智能体触到上下文或专业边界时再拆。
  4. Token、微调和压缩都要有对照数字,避免口号式优化。
  5. 结论写成可检查清单:接口、超时、评测集、回滚版本。

和智能体产品怎么接

龙虾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 命