一. OpenClaw 安装OpenClaw 是一个可执行任务的智能体我们给指令它不仅回答还能主动操作系统、访问网页、处理邮件、整理文件、发起提醒甚至自动编写代码。OpenClaw 是一个把 本地算力 大模型 Agent 自动化 玩到极致的开发者效率工具。OpenClaw 目标是让 AI 不只是给建议而是直接完成完整工程任务。​​OpenClaw 官网: https://openclaw.ai/Github 地址https://github.com/openclaw/openclawOpenClaw 技能合集: https://github.com/VoltAgent/awesome-openclaw-skillsClawbot、Moltbot 和 OpenClaw 其实是同一个开源项目名字演进顺序为Clawdbot → Moltbot → OpenClaw1. 安装方法OpenClaw 的安装被设计得极为友好即使是非开发者也能快速上手。系统要求不一定 Mac mini硬件极低2GB RAM 即可运行。环境支持 Mac, Windows, Linux需要安装 Node.js (pnpm) 或使用 Docker。1、推荐安装方式一键脚本直接通过终端执行以下命令。macOS/Linux 系统:curl -fsSL https://openclaw.ai/install.sh | bashWindows 系统#PowerShell iwr -useb https://openclaw.ai/install.ps1 | iex #CMD curl -fsSL https://openclaw.ai/install.cmd -o install.cmd install.cmd delinstall.cmd这会自动安装 Node.js≥22并完成基本配置。2、手动安装需要 Node.js ≥22并完成基本配置。使用 npmnpm i -g openclaw或使用 pnpmpnpm add -g openclaw安装完成后初始化并安装后台服务launchd / systemd 用户服务openclaw onboard3、从源码安装开发模式git clone https://github.com/openclaw/openclaw.git cd openclaw pnpm install pnpm ui:build # 首次运行会自动安装 UI 相关依赖并构建前端界面 pnpm build # 构建整个项目包含后端与相关模块 # 初始化 OpenClaw 并安装为系统后台服务开机自动运行 pnpm openclaw onboard --install-daemon # 开发模式监听 TypeScript 代码变更并自动重载网关服务 pnpm gateway:watch2. 配置说明我们推荐使用一键脚本安装。macOS/Linux 系统:curl -fsSL https://openclaw.ai/install.sh | bashWindows 系统#PowerShell iwr -useb https://openclaw.ai/install.ps1 | iex #CMD curl -fsSL https://openclaw.ai/install.cmd -o install.cmd install.cmd del install.cmd它会完成环境检测并且安装必要的依赖还会启动 onboarding 流程。​​然后会提醒你这个龙虾能力很强当然风险也很大我们选 **yes**no 就不安装了 就好了​​接下来我们就选快速启动 **QuickStart** 选项​​接下来我们需要配置一个大模型Model/Auth Provider 选择 AI 供应商国内外的供应商基本都支持。​​如果没有海外的账号配置咱们国内的 Qwen、MiniMax、智谱的 API key 也是可以的。选择飞书选择使用本地插件​​填入飞书id和秘钥​其他配置比如端口的设置 ​Gateway Port​按默认的 18789 即可比如 Skills、包的安装管理器选 npm 或其他可以一路 Yes 下去。​​选一些自己喜欢的 skills也可以直接跳过使用空格按键选择​​这些 API key没有的直接选 **no**​​最后这三个钩子可以开启主要做内容引导日志和会话记录​​安装完后就会自动访问 http://127.0.0.1:18789/chat就可以打开聊天界面让它开始工作。openclaw session new3. 配置飞书3.1 进行配对找到飞书开发者后台创建机器人添加机器人权限添加事件回调和设置给飞书机器人发消息获得配对码将配对码最后一句命令在服务器或者powershell执行​​3.2 openclaw进行飞书文档管理3.2.1 添加权限#飞书添加权限 { scopes: { tenant: [ docx:document, drive:drive, wiki:wiki:readonly, im:message:send_as_bot ] } } #在openclaw开启文档工具 openclaw config set channels.feishu.tools.doc true #启用文档工具4 openclaw多实例配置4.1 方案架构特点**强隔离**每个实例有独立的进程、网关、端口和数据存储一个实例故障不影响其他实例。**独立配置**通过不同的 profile​配置文件实现 API 密钥、工作空间、规则策略的完全分离。**灵活管理**可针对不同实例单独启停、升级或调整资源适合精细化运维。4.2 具体部署步骤1. 端口规划关键避免冲突为每个实例分配**唯一的端口段**建议间隔至少 20防止 CDP 子端口、浏览器调试端口冲突。示例规划实例名称主网关端口数据目录实例 A8083./openclaw实例 B8084.openclaw-development/实例 C8085.openclaw-leader/2. 准备独立的网关配置文件#设置配置文件配置档案--profile [rootiZ2zejauiv67mwdmw03f22Z .openclaw]# openclaw --profile leader setup [rootiZ2zejauiv67mwdmw03f22Z .openclaw]# openclaw --profile leader setup OpenClaw 2026.3.13 (61d171a) — I dont sleep, I just enter low-power mode and dream of clean diffs. Wrote ~/.openclaw-leader/openclaw.json Workspace OK: ~/.openclaw/workspace-leader Sessions OK: ~/.openclaw-leader/agents/main/sessions [rootiZ2zejauiv67mwdmw03f22Z .openclaw]# openclaw --profile development setup OpenClaw 2026.3.13 (61d171a) — I can run local, remote, or purely on vibes—results may vary with DNS. Wrote ~/.openclaw-development/openclaw.json Workspace OK: ~/.openclaw/workspace-development Sessions OK: ~/.openclaw-development/agents/main/sessions #配置端口 #第二个机器人 openclaw --profile leader gateway --port 8084 #第三个机器人 openclaw --profile development gateway --port 80853.进行安装#第二个机器人 openclaw --profile leader onboard openclaw --profile development onboard #查看状态 systemctl status --user openclaw-gateway-leader.service systemctl status --user openclaw-gateway-development.service #进入交互界面 # 核心命令一键打开 openclaw --profile leader tui4. 在从本地连接远程服务器#修改网关服务 vim openclaw.json gateway: { port: 8085, mode: local, bind: lan, #将loopback改为lan:使得其他地址也可以连接 controlUi: { allowedOrigins: [*] }, #建立隧道 点击服务器属性----点击隧道---填写目标地址​​选择浏览器---填入token​​显示需要在浏览器中配对​​到服务器中执行openclaw --profile leader logs --follow 或者openclaw logs --follow查看requestid#执行配对 openclaw --profile leader devices approve requestid5 OpenClaw CLI 参考手册一、全局选项在任何命令前使用选项说明​--dev​**开发模式**状态文件隔离至 ~/.openclaw-dev​网关端口偏移至 19001​浏览器等衍生端口自动偏移。​-h, --help​显示帮助信息。​--no-color​禁用 ANSI 彩色输出适用于日志重定向或无彩色终端。​--profile name​**命名配置文件**状态/配置目录隔离至 ~/.openclaw-name​支持多环境并行。​-V, --version​输出版本号。二、子命令速查表按功能分类分类命令功能简述**初始化与配置**​setup​初始化 ~/.openclaw/openclaw.json​ 和代理工作区。​configure​交互式向导设置认证凭证、设备信息和代理默认参数。​onboard​一站式向导配置网关、工作区和技能。​config​配置管理get/set/unset无子命令时启动配置向导。​reset​**保留 CLI**仅重置本地配置/状态文件。**网关与核心服务**​gateway​网关控制启动、停止、状态等。​daemon​​gateway​ 的旧别名兼容旧脚本。​health​查询运行中网关的健康状态。​logs​查看网关日志。​system​系统事件、心跳检测和在线状态管理。​status​展示各通道的健康状况及最近会话接收者。**代理与智能体**​agent​运行代理单次对话--local​ 表示本地嵌入运行。​agents​管理隔离的代理实例工作区、认证、路由。​skills​管理智能体技能增删改查。​models​配置或切换大语言模型。**浏览器自动化**​browser​管理专用 Chrome/Chromium 浏览器实例。**设备与配对**​devices​设备配对管理生成/撤销设备令牌。​pairing​辅助配对流程的实用工具。**通信与消息**​message​发送消息或执行频道动作加入、离开等。​channels​通道管理列出、创建、删除。​webhooks​Webhook 管理。​hooks​钩子工具集。​approvals​执行审批操作如技能需人工批准。**存储与记忆**​memory​记忆搜索工具从长期记忆中检索内容。​sessions​列出已存储的对话会话历史。​directory​目录管理联系人/频道目录。**节点与分布式**​node​单个节点控制。​nodes​多节点管理集群场景。**辅助工具**​doctor​健康检查 快速修复。​cron​定时任务调度器。​sandbox​沙箱工具安全执行代码或策略。​security​安全相关工具密钥、权限等。​dns​DNS 辅助工具本地服务发现。​docs​文档辅助工具打开/生成文档。**界面与输出**​dashboard​用当前 Token 打开 Web 控制台。​tui​终端交互式 UI 仪表盘。**版本与卸载**​update​CLI 自更新工具。​uninstall​卸载网关服务并删除本地数据保留 CLI。**其他**​acp​Agent Control Protocol 低级交互工具。​completion​生成 Shell 自动补全脚本。​help​显示所有命令的帮助信息。Profile启用的工具适用场景安全性​minimal​仅会话状态最小权限只读场景最高​messaging​messagingsessions消息机器人高​coding​fsruntimesessionsmemory编程助手中​full​所有工具完全访问低