OpenClaw 是一个本地优先、强调执行力的开源 AI 智能体框架。它相当于一个“云端大脑+本地肢体”的结合体，通过自然语言理解你的指令，并能真实地操作你的电脑、调用各种工具，而不仅仅是提供一个对话答案 。

官方网站：https://openclaw.ai/
github地址：https://github.com/openclaw/openclaw
中文社区：https://clawd.org.cn/
他人成果：https://openclaw.ai/showcase
skills仓库：https://clawhub.ai/skills?sort=downloads

它的核心特性可以归纳为以下几点：

特性维度 具体描述 关键优势/说明
核心定位 强执行力的AI智能体 不仅能对话，更能执行实际操作
系统架构 三层解耦：云端大脑(Orchestrator) + 协议桥(Gateway) + 本地执行端(Pi-embedded) 分工明确，云端负责思考，本地负责执行，安全高效
核心能力 模块化技能(Skills) 通过安装不同的技能插件，扩展功能边界，如搜索、操作文件等
安全机制 Cell Isolation沙箱 技能在隔离的虚拟环境中运行，限制对系统的直接访问
交互渠道 多平台支持 支持飞书、Telegram、Web UI等多种方式与你交互

OpenClaw 核心知识详解

要深入理解 OpenClaw，需要先了解其独特的三层架构和关键的安全设计。

核心架构：三层解耦

OpenClaw 的强大执行力源于其清晰的“三层解耦”架构，这能有效避免指令混乱和超时问题 。

  1. Orchestrator (云端大脑)：通常部署在云端或GPU集群上，负责最复杂的任务：理解你的自然语言指令，利用大模型（LLM）进行任务拆解和推理，决定需要调用哪些技能。
  2. Gateway (协议桥)：这是连接大脑和肢体的关键桥梁。它运行在本地或服务器上，负责指令的鉴权、流量管理，并将Orchestrator下发的通用指令翻译成Pi-embedded能理解的、针对特定环境的操作指令。如果指令没有响应，很可能是Gateway这一层的节点注册出了问题 。
  3. Pi-embedded (本地执行端)：这是真正干活的“肢体”。它运行在你的个人电脑（Mac、Linux、Windows）或树莓派上，在接收到Gateway的指令后，启动沙箱环境，动态加载并执行具体的Skill脚本（如截图、读写文件、模拟点击等）。执行结果最终会原路返回 。

核心安全：沙箱机制

由于OpenClaw被授予了操作电脑的高权限，安全性至关重要。为此，它实现了一套名为 “Cell Isolation”（单元隔离） 的沙箱机制 。

  • 独立运行环境：当Pi-embedded执行一个Skill时，会启动一个临时的、隔离的Python进程。这个进程拥有独立的虚拟环境（venv），即使Skill代码中包含恶意指令，也无法直接访问你的主系统文件 。
  • 依赖隔离：你在Skill的配置文件（如 claws.yaml）中定义的依赖库，也会被自动安装到这个隔离环境中，不会与你本地的Python开发环境产生冲突 。
  • 风险提示：尽管如此，授予AI执行Shell命令或控制浏览器的权限依然存在被恶意指令诱导的风险（例如提示词注入攻击）。因此，官方和社区都强烈建议将OpenClaw部署在独立的设备、虚拟机或云服务器上，避免与存储重要隐私信息的日常工作机混用 。

不同系统安装教程

OpenClaw 支持多平台部署，你可以根据自己的需求和条件选择最适合的方式。

准备工作（通用）

无论选择哪种安装方式，都需要准备以下几样东西 ：

  • Git：用于版本管理。
  • Node.js：核心运行环境，必须为 v20.x LTS 或更高版本（推荐 v22+ 或 v24+）。
  • API Key：大模型的访问密钥，如 OpenAI、Google Gemini、阿里云百炼等 。

Windows 系统安装

Windows原生环境并非OpenClaw最友好的运行环境，但通过以下步骤可以顺利完成。

  1. 环境准备：

    • 打开管理员 PowerShell：按 Win + X，选择 “Windows PowerShell (管理员)” 或 “终端(管理员)” 。
    • 解锁执行策略（关键步骤，避免报错）：在PowerShell中输入命令 Set-ExecutionPolicy Bypass -Scope Process -Force 。
    • 安装Node.js：推荐使用 nvm-windows 来安装和管理Node.js版本。可以从GitHub下载 nvm-setup.exe 安装，然后运行 nvm install 22 和 nvm use 22.22.0 。

  2. 一键安装OpenClaw：
    在管理员PowerShell中，粘贴并运行以下命令之一：

    • 官方脚本：iwr -useb https://openclaw.ai/install.ps1 | iex ,git有时间会拒绝访问，可能需要多次尝试
    • 国内镜像脚本（如果官方脚本下载慢）：iwr -useb https://clawd.org.cn/install.ps1 | iex

  3. 初始化与启动：使用国内镜像需要输入openclaw-cn

    • 安装完成后，运行初始化向导 openclaw onboard --flow quickstart。按照提示同意风险、选择模型并输入你的API Key、配置通道（飞书、企业微信等）、技能配置npm、钩子可以暂时跳过、安装gateway。
    • 重要配置：执行命令 openclaw config set gateway.mode local，将Gateway设置为本地模式 。
    • 启动Gateway服务：openclaw gateway start 。
    • 打开浏览器，访问 http://127.0.0.1:18789/?token=you_token，看到界面即表示成功 。
携带token访问
  • 带token启动，使用命令openclaw config get gateway.auth.token获取token 
    openclaw config get gateway.auth.token
  • 打开http://127.0.0.1:18789\?token=you_token

macOS 系统安装

macOS的安装过程相对顺畅，是本地开发测试的理想选择。

  1. 环境准备：

    • 安装Homebrew（推荐）：在终端中运行 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" 。
    • 安装Node.js：使用Homebrew安装最新LTS版 brew install node@22 。

  2. 一键安装OpenClaw：
    在终端中运行统一安装脚本 curl -fsSL https://openclaw.ai/install.sh | bash 。

  3. 初始化与启动：

    • 运行 openclaw setup 或 openclaw onboard --install-daemon 启动配置向导，完成API Key等设置 。
    • 启动Gateway服务：openclaw gateway start 。
    • 访问Web控制台：http://localhost:18789 。

Linux 系统安装（以Ubuntu为例）

Linux通常作为服务器部署的首选，可以保证7x24小时稳定运行。

  1. 环境准备：

    • 更新系统并安装Git：sudo apt update && sudo apt install git -y 。
    • 安装Node.js：使用NodeSource官方源安装v24.x版本。 
      curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt install -y nodejs

  2. 安装OpenClaw：
    在终端中运行安装脚本 curl -fsSL https://openclaw.ai/install.sh | bash 。

  3. 初始化与启动：

    • 运行 openclaw setup 或 openclaw onboard 完成配置 。
    • 设置Gateway模式为本地并启动：openclaw config set gateway.mode local，然后 openclaw gateway start 。
    • 如果需要开机自启，可以使用 sudo openclaw gateway install 。
    • 访问控制台：http://<你的服务器IP>:18789。如果远程访问，可能需要配置SSH隧道或防火墙放行该端口 。

安装后配置与常用命令

安装只是第一步，完成后的配置和调试也同样关键。

常用排错命令

在配置或使用过程中遇到问题，以下命令可以帮你快速定位 ：

  • openclaw doctor：运行诊断检查，查看环境配置是否有误。
  • openclaw gateway status / restart：查看Gateway状态或重启。
  • openclaw logs follow：实时查看运行日志，这是定位Bug最有效的方法。
  • openclaw config：查看或修改当前的配置项。

openclaw卸载重装（如果之前安装有残留）**

如果之前安装过程被中断，可能有残留配置导致问题：

  1. 以管理员身份打开PowerShell

  2. 先卸载：

    npm uninstall -g openclaw-cn

  3. 删除配置文件（备份一下）：

    # 备份配置（可选）
copy C:\Users\HX\.opencLaw\openclaw.json C:\Users\HX\.opencLaw\openclaw.json.bak

# 删除配置目录（谨慎操作）
rm -r C:\Users\HX\.opencLaw

clawhub安装skills常用命令

1.安装clawhub

npm install -g clawhub

2.验证clawhub是否安装

clawhub -V

3.登录clawhub

设置token

登录clawhub官网–>点击头像–>settings–>API token

设置好token后使用token登录
clawhub login --token you_token

如果本地不登录可能会导致安装失败，报错：Rate limit exceeded

4.使用clawhub安装skills

clawhub install 需要安装的技能

eg:
clawhub install tavily-search

5.使用clawhub卸载技能

clawhub uninstall 需要卸载的技能
# 人工智能
Logo
龙虾开发者社区

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地，聚焦技能开发、插件实践与部署教程，为开发者提供可直接落地的方案、工具与交流平台，助力高效构建与落地 AI 应用

更多推荐

学生党福音：OpenClaw+nanobot搭建学习监督助手

本文介绍了如何在星图GPU平台上自动化部署🐈 nanobot：超轻量级OpenClaw镜像，构建智能学习监督助手。该方案利用轻量级模型实现网课进度跟踪、自动生成练习题和错题整理功能，特别适合学生群体通过QQ机器人实现移动端学习管理，显著提升学习效率。

avatar 龙虾开发者社区

OpenClaw+GLM-4.7-Flash语音交互：对接Whisper实现语音控制

本文介绍了如何在星图GPU平台上自动化部署【ollama】GLM-4.7-Flash镜像，构建语音交互系统。该系统结合Whisper语音识别与GLM-4.7-Flash的指令理解能力，实现智能家居控制等场景的语音操作，提升日常任务执行效率。

avatar 龙虾开发者社区

OpenClaw创意工坊：用nanobot镜像生成技术海报文案

本文介绍了如何在星图GPU平台上自动化部署🐈 nanobot：超轻量级OpenClaw镜像，快速生成技术海报文案。该镜像基于Qwen3-4B模型，能将复杂技术术语转化为通俗表达，适用于技术活动宣传、社交媒体推广等场景，显著提升内容创作效率。

avatar 龙虾开发者社区