OpenClaw：AI智能体极速安装指南

OpenClaw是一款功能强大的智能体工具，能够执行操作系统操作、网页访问、邮件处理等自动化任务。支持Mac、Windows和Linux系统，提供一键脚本安装方式，也可手动安装或从源码构建。安装后需配置大模型API密钥（支持国内外供应商）和飞书等第三方服务。支持多实例隔离部署，每个实例拥有独立端口和配置。提供丰富的CLI命令集，涵盖初始化配置、网关管理、智能体控制等功能。OpenClaw将AI从建

2301_80865861

478人浏览 · 2026-05-07 18:12:22

2301_80865861 · 2026-05-07 18:12:22 发布

一. 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	所有工具	完全访问	低

openEuler 社区

openEuler 是由开放原子开源基金会孵化的全场景开源操作系统项目，面向数字基础设施四大核心场景（服务器、云计算、边缘计算、嵌入式），全面支持 ARM、x86、RISC-V、loongArch、PowerPC、SW-64 等多样性计算架构

更多推荐

AI 智能体（AI Agent）初步介绍：从概念到全球排行榜

📅 更新时间：2026年5月 | ✍️ 作者原创，欢迎转载注明出处AI 智能体（AI Agent）是一种能够自主感知环境、制定计划、执行行动并从反馈中学习的人工智能系统。🔍感知（Perceive）：接收来自环境的多模态输入（文本、图像、代码等）🧠推理（Reason）：基于大语言模型（LLM）进行复杂推理和决策🛠️行动（Act）：调用工具、编写代码、操作系统、发送请求🔄反思（Reflect