🦞 OpenClaw 专区 - 小派工具箱

📦 安装部署 Installation

1🪟 Windows 一键安装（推荐）

环境要求：Windows 10/11 64位，已安装 Node.js 18+ 和 Git

打开 PowerShell（管理员模式）
执行以下命令安装 OpenClaw CLI：

npm install -g @openclaw/cli

3. 验证安装：

openclaw --version

✅ 如显示版本号（如 v2.1.0）说明安装成功。

2🪟 Windows 手动安装

如一键安装失败，可使用手动方式：

# 克隆仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# 安装依赖
npm install

# 全局链接
npm link

⚠️ 注意：确保 Node.js 版本 ≥ 18.0.0，过低版本会导致依赖安装失败。可使用 node -v 查看当前版本。

3🍎 / 🐧 macOS / Linux 安装

环境要求：macOS 12+ 或 Ubuntu 20.04+ / CentOS 7+，已安装 Node.js 18+ 和 Git

# 使用 npm 全局安装
sudo npm install -g @openclaw/cli

# 验证
openclaw --version

💡 提示：macOS 用户如遇到权限错误，可尝试 npm install -g @openclaw/cli（不加 sudo），或使用 nvm 管理 Node.js 版本。

!🚧 避坑指南（常见问题）

❌ 问题1：npm install 报错 EACCES
✅ 解决：Windows 使用管理员 PowerShell；macOS/Linux 使用 sudo 或在用户目录下安装。

❌ 问题2：openclaw 命令找不到
✅ 解决：检查 npm 全局安装路径是否在 PATH 环境变量中。
npm config get prefix → 将该路径添加到系统 PATH。

❌ 问题3：端口被占用（Port in use）
✅ 解决：使用 openclaw gateway --port 9090 指定其他端口，或 lsof -i :8080 查找并关闭占用进程。

❌ 问题4：API 请求超时
✅ 解决：检查网络连接，如使用代理请配置 HTTP_PROXY 环境变量；或者检查 API Key 是否有效。

🚀 基础使用 Getting Started

1🔄 初始化工作空间

首次使用需初始化工作目录，OpenClaw 会自动创建配置文件并下载核心依赖。

# 创建并进入项目目录
mkdir my-openclaw-project
cd my-openclaw-project

# 初始化
openclaw init

💡 说明：初始化后目录结构如下：
my-openclaw-project/
├── openclaw.config.json — 主配置文件
├── skills/ — 自定义 Skill 存放目录
└── gateway/ — 网关配置

2🔌 启动网关（Gateway）

网关是 OpenClaw 的核心服务，负责管理 Agent 通信和 Skill 调用。

# 启动网关（默认端口 8080）
openclaw gateway start

# 指定端口启动
openclaw gateway start --port 9090

# 后台运行
openclaw gateway start --daemon

# 查看网关状态
openclaw gateway status

# 停止网关
openclaw gateway stop

✅ 启动成功后，访问 http://localhost:8080 可查看网关状态面板。

3⚙️ 面板配置

通过 Web 面板可直观管理 Agent、Skill 和配置项。

# 启动管理面板（内置）
openclaw panel

# 指定端口
openclaw panel --port 3000

# 面板功能：
# - 查看已安装的 Skill 列表
# - 管理 API Key
# - 配置 Agent 参数
# - 查看运行日志

💡 提示：面板默认绑定 127.0.0.1（仅本地访问），如需远程访问请添加 --host 0.0.0.0（注意安全风险）。

4🔑 API Key 管理

API Key 用于外部应用调用 OpenClaw 网关，支持创建多个 Key 分配不同权限。

# 生成新 API Key
openclaw apikey create --name "my-app" --role admin

# 列出所有 Key
openclaw apikey list

# 删除 Key
openclaw apikey delete 

# 配置环境变量（推荐在 .env 文件中设置）
export OPENCLAW_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

⚠️ 安全提示：API Key 具有完整权限，请妥善保管。不要在代码中硬编码 Key，建议使用环境变量或密钥管理服务。

🧩 热门 SKLII 组合精选Skill集

📂 文件 & 系统操作

🗂️

File Explorer

文件浏览/搜索/管理，支持批量操作和路径导航。

文件管理系统工具

⭐ ★★★★★ (4.9) ⚡ 系统内置

🔍

Code Search

跨文件代码搜索，支持正则、模糊匹配和路径过滤。

搜索开发

⭐ ★★★★★ (4.8) ⚡ 系统内置

📝

Text Processor

文本处理工具集：替换、格式化、编码转换、正则替换。

文本工具

⭐ ★★★★☆ (4.7) ⚡ 系统内置

🌐 网络 & API

🌍

Web Fetcher

HTTP 请求工具，支持 GET/POST、自定义 Headers、Cookie 管理。

网络 API

⭐ ★★★★★ (4.9) ⚡ 系统内置

🔐

API Gateway

API 网关管理，支持路由转发、限流、鉴权、日志记录。

安全网关

⭐ ★★★★★ (4.8) ⚡ 系统内置

📡

WebSocket Client

WebSocket 客户端，支持实时消息推送、订阅/发布模式。

实时通信

⭐ ★★★★☆ (4.6) ⚡ 系统内置

🤖 AI & 数据处理

🧠

LLM Proxy

大模型代理，统一接口调用多款 LLM（GPT-4/Claude/DeepSeek）。

AI LLM

⭐ ★★★★★ (5.0) ⚡ 系统内置

📊

Data Parser

数据解析器，支持 JSON/XML/CSV/YAML 格式互相转换和分析。

数据解析

⭐ ★★★★★ (4.8) ⚡ 系统内置

🖼️

Image Generator

AI 图像生成，对接 Midjourney / Stable Diffusion / DALL·E。

AI绘画图像

⭐ ★★★★★ (4.9) ⚡ 系统内置

⚡ 自动化 & 持续集成

🔄

Task Scheduler

任务调度器，支持 Cron 表达式定时执行自定义任务和工作流。

自动化调度

⭐ ★★★★★ (4.8) ⚡ 系统内置

🚀

Deployer

部署工具，支持 Git 拉取/构建/发布/回滚一键部署。

部署 CI/CD

⭐ ★★★★★ (4.9) ⚡ 系统内置

📋

Logger

日志管理，支持日志收集/过滤/搜索/导出，可对接外部日志系统。

日志监控

⭐ ★★★★☆ (4.7) ⚡ 系统内置

🎬 AI 漫剧 & 短视频创作 AI Comic & Short Video

🎬

AI漫剧生成器

用豆包+即梦AI一键生成AI漫剧，支持剧本→分镜→视频→配音全流程自动化。

AI漫剧视频自动化

⭐ ★★★★★ (5.0) 📖 全集教程

🎞️

Seedance 2.0 短剧

即梦AI最新Seedance 2.0模型驱动，生成高质量AI短剧，支持角色一致性和镜头控制。

AI短剧生成

⭐ ★★★★★ (4.9) 📖 全集教程

🎙️

AI配音 & 配乐

AI语音合成、情感配音、背景音乐生成，一键生成漫剧/短剧的完整音频轨道。

AI配音音频

⭐ ★★★★☆ (4.8) 📖 全集教程

⚡ 进阶玩法 Advanced

🧩 自定义 Skill 开发

编写自己的 Skill 扩展 OpenClaw 功能。每个 Skill 是一个标准化的模块，包含配置文件和逻辑代码。

# 创建 Skill
openclaw skill create my-skill

# 编辑 Skill 代码
cd skills/my-skill
# index.js — 核心逻辑
# manifest.json — 配置和元数据

# 安装 Skill
openclaw skill install ./skills/my-skill

# 卸载
openclaw skill uninstall my-skill

💡 参考：官方 Skill 模板地址 https://github.com/openclaw/skill-template

🤝 多 Agent 协同

配置多个 Agent 协同工作，实现复杂任务自动化。每个 Agent 可配置独立的 Skill 集和模型。

# openclaw.config.json
{
  "agents": [
    {
      "name": "coder",
      "skills": ["file-explorer", "code-search"],
      "model": "gpt-4"
    },
    {
      "name": "designer",
      "skills": ["image-gen", "web-fetcher"],
      "model": "claude-3"
    }
  ]
}

⚠️ 注意：多 Agent 协作会增加资源消耗，建议在 4GB 以上内存的服务器上运行。

🏠 本地模型对接（Ollama）

使用 Ollama 部署本地大模型（如 Llama 3、Qwen 2），无需外网即可使用 AI 能力。适合数据敏感场景。

# 1. 安装 Ollama
# https://ollama.com/download

# 2. 下载模型
ollama pull llama3.2:1b
ollama pull qwen2.5:7b

# 3. 配置 OpenClaw 使用本地模型
# openclaw.config.json
{
  "model": {
    "provider": "ollama",
    "endpoint": "http://localhost:11434",
    "name": "llama3.2:1b"
  }
}

💡 推荐模型：低配机器用 llama3.2:1b（1GB内存），高配用 qwen2.5:7b（8GB内存）。

OpenClaw 完全指南

OpenClaw 专区 - 小派工具箱