一. OpenClaw 安装

OpenClaw 是一个可执行任务的智能体，我们给指令，它不仅回答，还能主动操作系统、访问网页、处理邮件、整理文件、发起提醒甚至自动编写代码。

OpenClaw 是一个把 本地算力 + 大模型 Agent 自动化 玩到极致的开发者效率工具。

OpenClaw 目标是让 AI 不只是给建议，而是直接完成完整工程任务。

​

​

• OpenClaw 官网: https://openclaw.ai/
• Github 地址：https://github.com/openclaw/openclaw
• OpenClaw 技能合集: https://github.com/VoltAgent/awesome-openclaw-skills

Clawbot、Moltbot 和 OpenClaw 其实是同一个开源项目，名字演进顺序为：

Clawdbot → Moltbot → OpenClaw

---

1. 安装方法

OpenClaw 的安装被设计得极为友好，即使是非开发者也能快速上手。

系统要求（不一定 Mac mini）：

• 硬件：极低，2GB RAM 即可运行。
• 环境：支持 Mac, Windows, Linux，需要安装 Node.js (pnpm) 或使用 Docker。

1、推荐安装方式（一键脚本）：

直接通过终端，执行以下命令。

macOS/Linux 系统:

curl -fsSL https://openclaw.ai/install.sh | bash

Windows 系统：

#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并完成基本配置。

使用 npm：

npm i -g openclaw

或使用 pnpm：

pnpm add -g openclaw

安装完成后，初始化并安装后台服务（launchd / systemd 用户服务）：

openclaw onboard

3、从源码安装（开发模式）

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:watch

---

2. 配置说明

我们推荐使用一键脚本安装。

macOS/Linux 系统:

curl -fsSL https://openclaw.ai/install.sh | bash

Windows 系统：

#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 new

3. 配置飞书

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 子端口、浏览器调试端口冲突）。示例规划：

实例名称	主网关端口	数据目录
实例 A	8083	./openclaw
实例 B	8084	.openclaw-development/
实例 C	8085	.openclaw-leader/

2. 准备独立的网关配置文件

#设置配置文件，配置档案（--profile）
[root@iZ2zejauiv67mwdmw03f22Z .openclaw]# openclaw --profile leader setup

[root@iZ2zejauiv67mwdmw03f22Z .openclaw]# openclaw --profile leader setup

🦞 OpenClaw 2026.3.13 (61d171a) — I don't 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
[root@iZ2zejauiv67mwdmw03f22Z .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 8085

3.进行安装

#第二个机器人
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 tui

4. 在从本地连接远程服务器

#修改网关服务
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 requestid

5 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​	messaging+sessions	消息机器人	高
​coding​	fs+runtime+sessions+memory	编程助手	中
​full​	所有工具	完全访问	低