大家好，我是龙力坤。

之前我录过一集 OpenClaw 的安装教程，但里面涉及了一些海外聊天平台和内网组件的内容，在国内平台没法审核发布。所以这次我重新录制了一版更“经典”的核心教程：去掉了海外平台，将通信渠道调整为国内的飞书，专注本地机器部署。

如果你有在服务器上部署或者公司内部分发的需求，可以去我的 YouTube 频道观看完整版。今天，我们只演示如何在本地机器上通过 Docker 干净、快速地部署 OpenClaw 项目。

第一阶段：通过 Docker 本地部署

在本地部署有很多方式（比如一键安装脚本或 NPM 等）。为了保持本机系统环境的干净，我这里推荐使用 Docker 拉取容器进行部署。

如果你更喜欢使用 NPM 部署，请确保你的 Node.js 版本在 22 以上（推荐下载长期支持版如 24.14），除了安装命令不同，后续的配置步骤是一模一样的。下面我们以 Docker 为例详细演示：

1. 拉取源码 首先从 GitHub 上面拉取 OpenClaw 的仓库代码到本地。
2. 执行化脚本 进入项目目录后，你会发现一个名为 docker-setup.sh 的脚本。我们可以直接运行这个脚本。
3. 沙箱环境部署 这个脚本默认在本地构建镜像。如果你不想本地编译，也可以通过设置环境变量，直接指令使用 GitHub 上面已经构建好的官方镜像。启用沙箱环境并运行这个脚本即可，部署可能需要一段时间。

第二阶段：初始化网关配置

部署成功以后，进入关键的面版配置步骤。

屏幕下方会首先弹出一长串的安全风险提醒，建议详细阅读后选择 Yes 同意协议。接下来系统会询问你使用“快速配置”还是“手动配置”，我们选择手动配置，逐一梳理。

(提示：如果你之前安装过，它会检测到旧配置并询问是否沿用，选择更新或沿用都可以。)

1. 基础工作区设置

设置本机还是远程，以及存放工作空间数据的位置，这两项我们直接回车使用默认即可。

2. 模型设置策略

接下来是核心的模型设置。虽然 OpenClaw 现在非常火，但很多高阶效果依赖顶级大模型能力。如果你只是想简单体验功能，可以使用价格便宜的模型或者本地跑一个模型；如果你希望它真正稳定帮你完成复杂的日常工作，那么使用更强劲的大模型会更加合适。（本期不作强制要求，依据你的实际场景评估）

3. 网关网络通信设置

• 网关端口：直接回车使用默认。
• 绑定 IP 地址：如果是自己单机使用，选择 127.0.0.1；如果想在公司局域网内使用，可以选择 0.0.0.0（但务必做好防火墙和网络隔离）。
• 网关认证方式：坚定选择系统推荐的 Token 方式。

4. Hook 与自动化配置 (强烈建议开启)

网络搜索和聊天软件集成选项我们先选择“否”跳过（等主程序跑通了回头再配）。最后是几个非常实用的 Hook 配置，许多教程会建议跳过，但我极力推荐你开启：

1. 用于自动化 Agent 的初始化：当 Gateway 启动时，能自动执行初始化的指令。
2. 在 Bootstrap 阶段，可以自动往工作区注入额外规则文件、模板或工具配置。
3. 命令日志 (Command Log)：把所有命令事件记录到日志里，当你排查问题或复盘后台到底发生了什么时，价值连城。
4. Session Memory：创建新对话时，系统会自动把上下文保存到 Agent 工作区，用于记忆管理和现场恢复。

配置完成后，我们重新启动一下程序，让新配置生效。

第三阶段：运行测试与飞书接入

基础连通性测试

由于目前是本地环境，直接在浏览器访问 127.0.0.1 加上你刚才配置的端口号，就能打开网页的管理面板了。

如果是新设备，首先需要输入 Token 获取授权并按页面提示完成设备配对。配置完毕后发出消息，若能进入正常对话收到回复，就说明服务运行正常！

（为了后续命令行操作方便，比如不用每次输超长的 Docker 容器命令，建议你在 .zshrc 或 .bash_profile 里给 docker compose run... 配置一个本地的命令别名）。

接入飞书平台

刚才我们跳过了聊天软件集成，现在我们要进行实名配置：如何通过飞书来随时随地呼唤我们的 Agent。

在此，我们使用 OpenClaw 提供的引导程序进行配置：

1. 进入 Config 选项 -> 选择 Channel -> 选择 飞书。按照提示确认安装飞书插件。
2. 前往飞书开放平台创建应用
   • 打开 飞书开放平台，创建一个【企业自建应用】，并为它添加【机器人】能力（填好机器人的名称和描述）。
3. 注入权限
   • 在权限管理页面，点击【批量导入】。
   • 将 OpenClaw 官方文档中提供的飞书专属 JSON 权限数据粘贴进去一键导入（权限包括消息收发、文档读取等基础条件）。
4. 绑定密钥与网关
   • 接着在【凭证与基础信息】面板，获取 App ID 和 App Secret。
   • 回到 OpenClaw 配置界面里面，依次输入 App Secret和 App ID。
   • 连接方式选择 WebSocket。
   • 域名选择 飞书.cn。
   • 群聊暂时设置为禁用，私聊和显示名称选择默认的 No。最后选择你要绑定的 Agent 完成配置。
5. 事件订阅与上线
   • 回到飞书后台的【事件订阅】页面，选择【使用长连接事件】，并务必添加 im.message.receive_v1 这个事件（注意：做这一步时你的 OpenClaw 网关必须处于运行状态，否则保存会失败）。
   • 最后，在飞书平台内创建版本并发布应用！

现在，打开你手机端的飞书 APP，搜索刚才创建的机器人，随意发送一条消息。它会回复要求你进行设备配对并提供验证码。在本地机器终端内输入指定的配对命令，你的专属飞书机器人助手就正式上线了！

第四阶段：给 Agent 装配 Skill (技能)

光能聊天还不够，我们还得给 Agent 赋予真正干活的能力，这主要通过装配 Skill 插件来实现。

你可以去官方网站或社区寻找好用的现成插件。把下载好的 Markdown 或脚本文件直接丢进你本地的 Skill 目录，刷新页面，你会发现它已经“掌握”了新技能。

⚠️ 安全警告： 在安装第三方的 Skill 脚本时，务必自己花两分钟审查一下源码，防范潜在的恶意后门和代码风险！

学会部署、接入飞书、安装 Skill 之后，你就真正拥有一名 24 小时待命的随身 AI 助理了！快去动手试试吧！