OpenClaw 使用简介

目录

1. 概述
2. 安装与配置
3. Skills 系统详解
4. 工作空间管理
5. 任务管理
6. 主流 Skills 安装指南
7. CLI 命令参考
8. 最佳实践
9. 常见问题

---

概述

OpenClaw 是一个开源、可自托管的常驻 Agent 平台，其核心优势在于庞大的 Skills（技能插件）生态。通过模块化的 Skills 系统，OpenClaw 能够扩展出几乎无限的功能，从代码开发到内容创作，从数据处理到商业策略，覆盖 18 大核心场景。

核心特性

• 按需加载，轻量高效：无需一次性安装所有技能，仅选择高频使用的插件
• 社区共享，零成本复用：全球开发者持续贡献开源技能，通过 ClawHub 一键安装
• 自定义扩展，适配专属需求：支持基于 AgentSkills 开放规范编写专属 Skill

---

安装与配置

系统要求

• Python 3.10+
• Node.js 18+
• Docker（推荐）
• 足够的算力支撑 AI 模型推理

安装方式

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

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

方式二：npm/pnpm 手动安装

npm install -g openclaw
# 或
pnpm add -g openclaw

方式三：Docker 安装（最安全）

docker pull openclaw/openclaw
docker run -d -p 3000:3000 -v ~/.openclaw:/root/.openclaw openclaw/openclaw

方式四：Windows WSL2 安装

# 在 WSL2 环境中执行
wget https://openclaw.ai/install.sh
chmod +x install.sh
./install.sh

配置文件

OpenClaw 使用 JSON5 格式的配置文件，位于：

• Windows: C:\Users\<Your_Username>\.openclaw\openclaw.json
• macOS/Linux: ~/.openclaw/openclaw.json

最小配置示例

{
  // 模型配置
  "models": {
    "mode": "merge",
    "providers": {
      "openai": {
        "baseUrl": "https://api.openai.com/v1",
        "apiKey": "sk-your-api-key-here",
        "models": [
          {
            "id": "gpt-4o",
            "name": "GPT-4 Omni"
          }
        ]
      }
    }
  },
  
  // Skills 配置
  "skills": {
    "registry": "https://clawhub.ai",
    "autoUpdate": true
  },
  
  // 网关配置
  "gateway": {
    "bind": "localhost",
    "port": 3000
  },
  
  // 控制面板
  "controlUi": {
    "enabled": true,
    "allowInsecureAuth": false
  }
}

添加自定义模型提供商

{
  "models": {
    "providers": {
      "qwen-bailian": {
        "baseUrl": "https://dashscope-intl.aliyuncs.com/compatible-mode/v1",
        "apiKey": "sk-your-api-key-here",
        "api": "openai-completions",
        "models": [
          {
            "id": "qwen3-coder-plus",
            "name": "Qwen3 Coder Plus"
          }
        ]
      }
    }
  }
}

---

Skills 系统详解

Skills 加载优先级

OpenClaw 的 Skills 从 4 个位置加载，名称冲突时按以下优先级生效（从高到低）：

优先级	位置	类型	路径	适用场景
最高	工作区技能	<workspace>/skills/	单智能体专属	推荐自定义技能放这里
中	本地/托管技能	~/.openclaw/skills/	本机所有代理共享	用户个性化定制
低	内置技能	随安装包自带	基础默认技能	核心功能层
最低	自定义额外目录	skills.load.extraDirs	多代理共享	通用技能包

关键规则：若同名技能出现在多个位置，高优先级会覆盖低优先级。

Skills 目录结构

skill-name/
├── SKILL.md          # 技能定义文件（必需）
├── references/       # 知识库和规程文件
├── assets/          # 模板和静态资源
└── scripts/         # 可执行脚本

SKILL.md 格式

---
name: skill-name
description: 技能描述
tags: [tag1, tag2]
os: [windows, linux, macos]  # 支持的操作系统
binaries: [python, node]      # 依赖的二进制文件
version: 1.0.0
author: your-name
---

# 技能指令

当用户输入包含特定关键词时，执行以下操作...

## 示例

示例命令和用法

安装 Skills 的三种方式

方式一：ClawHub 一键安装（推荐）

ClawHub 是 OpenClaw 官方技能市场，已收录 9000+ 款技能。

# 搜索技能
clawhub search <keyword>

# 安装技能到当前工作区（默认路径：./skills）
clawhub install <skill-name>

# 安装到全局
clawhub install -g <skill-name>

# 安装特定版本
clawhub install <skill-name>@1.2.3

# 更新已安装的技能
clawhub update <skill-name>
clawhub update --all  # 更新所有技能

方式二：手动安装

# 1. 下载 Skill 到工作区技能目录
mkdir -p ./skills
cd ./skills
git clone https://github.com/user/skill-name.git

# 2. 使 Skill 生效
openclaw skills reload

# 3. 验证 Skill 是否加载
openclaw skills list

方式三：通过 npm 安装

npm install -g @openclaw/skill-name
openclaw skills link

---

工作空间管理

工作空间概念

工作空间（Workspace）是 OpenClaw 中隔离不同项目环境和记忆的机制。每个工作空间拥有独立的：

• Skills
• 对话历史
• 记忆存储
• 配置文件

工作空间目录结构

~/.openclaw/workspace/
├── default/              # 默认工作空间
│   ├── memory/          # 记忆存储
│   ├── skills/          # 工作区专属技能
│   └── history/         # 对话历史
└── project-a/           # 自定义工作空间
    ├── memory/
    ├── skills/
    └── history/

工作空间操作命令

# 列出所有工作空间
openclaw workspace list

# 创建新工作空间
openclaw workspace create <name>

# 切换到指定工作空间
openclaw workspace switch <name>

# 删除工作空间
openclaw workspace delete <name>

# 复制工作空间
openclaw workspace copy <source> <target>

# 导出工作空间
openclaw workspace export <name> > workspace-backup.json

# 导入工作空间
openclaw workspace import < backup.json

工作空间配置

在工作空间目录下创建 openclaw.json 文件，可以覆盖全局配置：

{
  // 工作空间专属模型配置
  "models": {
    "default": "gpt-4o"
  },
  
  // 工作空间专属 Skills
  "skills": {
    "load": [
      "./skills/custom-skill"
    ]
  },
  
  // 记忆配置
  "memory": {
    "enabled": true,
    "maxItems": 1000,
    "retentionDays": 30
  }
}

---

任务管理

基于会话的任务管理

OpenClaw 提供了一系列斜杠命令（Slash Commands）用于任务管理：

命令	功能描述	使用场景
/new	开启新会话线程	切换任务或节省 token
/status	查看当前会话状态	查看模型、上下文、队列等信息
/memory	查看或管理 AI 记忆	查询 AI 记住的信息
/reset	重置当前会话	清空上下文后重新开始
/history	查看会话历史记录	回顾之前的对话
/pause	暂停当前任务	临时停止 AI 执行
/continue	继续执行暂停的任务	恢复执行
/cancel	取消当前任务	终止执行

使用示例

用户: /new 开始新的代码审查任务

AI: 已开启新会话，上下文已清空。

用户: 请帮我审查这个 PR 的代码
[上传代码]

用户: /status

AI: 当前会话状态：
- 模型: gpt-4o
- 上下文长度: 2456 tokens
- 工作空间: project-a
- 活跃 Skills: code-review, file-reader

用户: /memory

AI: 当前记忆内容：
1. 项目使用 React + TypeScript 技术栈
2. 代码规范遵循 Airbnb JavaScript Style Guide

基于 Skills 的自动化任务

通过安装特定的 Skills，可以实现高级任务管理功能：

1. 任务规划 Skill

# 安装任务规划 Skill
clawhub install task-planner

使用示例：

用户: @task-planner 帮我规划本周的开发任务

AI: 我将为你创建本周任务计划：

任务 1: 完成用户认证模块
- 优先级: 高
- 预计时间: 8 小时
- 截止日期: 2026-03-12

任务 2: 修复支付流程 Bug
- 优先级: 中
- 预计时间: 4 小时
- 截止日期: 2026-03-13

是否开始执行？

2. 项目管理 Skill

# 安装项目管理 Skill
clawhub install project-management

功能包括：

• 创建和管理项目任务
• 设置任务优先级和截止日期
• 跟踪任务进度
• 生成项目报告

3. 定时任务 Skill

# 安装定时任务 Skill
clawhub install scheduled-tasks

使用示例：

用户: 每天早上 9 点发送项目进度报告

AI: 已创建定时任务：
- 任务名称: 每日项目报告
- 执行时间: 每天 09:00
- 执行内容: 收集项目进度并发送报告

记忆管理

OpenClaw 的记忆系统允许 AI 记住重要信息，并在后续对话中使用。

记忆操作命令

# 查看记忆内容
openclaw memory list

# 添加记忆项
openclaw memory add "关键信息"

# 删除记忆项
openclaw memory remove <id>

# 清空所有记忆
openclaw memory clear

# 导出记忆
openclaw memory export > memory-backup.json

# 导入记忆
openclaw memory import < memory-backup.json

记忆配置

在 openclaw.json 中配置记忆参数：

{
  "memory": {
    "enabled": true,           // 是否启用记忆
    "maxItems": 1000,         // 最大记忆项数
    "retentionDays": 30,      // 记忆保留天数
    "autoConsolidate": true,   // 自动合并相似记忆
    "importanceThreshold": 0.7 // 记忆重要性阈值
  }
}

---

主流 Skills 安装指南

开发编程类

1. Code Assistant（代码助手）

clawhub install code-assistant

功能特性：

• 代码补全和建议
• 代码审查和优化
• 多语言支持（Python、JavaScript、Java、Go 等）
• 调试辅助

2. Git Manager（Git 管理）

clawhub install git-manager

功能特性：

• Git 命令辅助
• 分支管理
• 冲突解决
• PR 创建和审查

3. Docker Helper（Docker 助手）

clawhub install docker-helper

功能特性：

• Docker 命令生成
• Dockerfile 编写
• 容器管理
• 镜像优化建议

内容创作类

4. Content Writer（内容创作）

clawhub install content-writer

功能特性：

• 文章大纲生成
• 内容扩写
• SEO 优化
• 多语言翻译

5. Image Generator（图像生成）

clawhub install image-generator

功能特性：

• 文生图
• 图生图
• 图像编辑
• 风格转换

效率工具类

6. File Manager（文件管理）

clawhub install file-manager

功能特性：

• 文件搜索和过滤
• 批量重命名
• 格式转换
• 内容提取

7. Web Scraper（网页抓取）

clawhub install web-scraper

功能特性：

• 网页内容提取
• 数据清洗
• 自动化浏览
• 截图保存

数据处理类

8. Data Analyst（数据分析）

clawhub install data-analyst

功能特性：

• 数据清洗
• 统计分析
• 可视化生成
• 报告撰写

9. Database Manager（数据库管理）

clawhub install database-manager

功能特性：

• SQL 查询生成
• 数据库连接管理
• 数据导入导出
• 性能优化建议

办公集成类

10. Google Workspace

clawhub install google-workspace

功能特性：

• Gmail 邮件管理
• Google 日历同步
• Drive 文件管理
• Docs/Sheets 协作

11. Slack Integration

clawhub install slack-integration

功能特性：

• 消息发送和接收
• 频道管理
• 文件共享
• 通知提醒

安装推荐组合

开发者套装

clawhub install code-assistant git-manager docker-helper file-manager

内容创作者套装

clawhub install content-writer image-generator file-manager web-scraper

数据分析师套装

clawhub install data-analyst database-manager file-manager web-scraper

---

CLI 命令参考

系统管理命令

# 查看 OpenClaw 运行状态
openclaw status

# 健康检查
openclaw health

# 自动修复配置问题
openclaw doctor

# 安全审计
openclaw security audit --deep

# 查看版本
openclaw version

# 更新 OpenClaw
openclaw update

模型管理命令

# 列出所有可用模型
openclaw models list

# 查看模型详细信息
openclaw models show <model-name>

# 设置默认模型
openclaw models set <model-name>

# 测试模型连接
openclaw models test <model-name>

# 添加自定义模型
openclaw models add <name> <base-url> <api-key>

Skills 管理命令

# 列出已加载的 Skills
openclaw skills list

# 显示 Skill 详细信息
openclaw skills show <skill-name>

# 重新加载 Skills
openclaw skills reload

# 禁用 Skill
openclaw skills disable <skill-name>

# 启用 Skill
openclaw skills enable <skill-name>

# 卸载 Skill
openclaw skills uninstall <skill-name>

# 检查 Skill 依赖
openclaw skills check <skill-name>

网关服务命令

# 启动网关
openclaw gateway start

# 停止网关
openclaw gateway stop

# 重启网关
openclaw gateway restart

# 查看网关状态
openclaw gateway status

# 查看网关日志
openclaw gateway logs

配置管理命令

# 查看配置
openclaw config get <key>

# 设置配置项
openclaw config set <key> <value>

# 删除配置项
openclaw config unset <key>

# 编辑配置文件
openclaw config edit

# 验证配置文件
openclaw config validate

日志和调试命令

# 查看实时日志
openclaw logs --follow

# 查看错误日志
openclaw logs --level error

# 清空日志
openclaw logs clear

# 导出日志
openclaw logs export > logs.txt

# 调试模式启动
openclaw --debug start

插件管理命令

# 列出已安装插件
openclaw plugin list

# 安装插件
openclaw plugin install <plugin-name>

# 卸载插件
openclaw plugin uninstall <plugin-name>

# 更新插件
openclaw plugin update <plugin-name>

# 禁用插件
openclaw plugin disable <plugin-name>

# 启用插件
openclaw plugin enable <plugin-name>

---

最佳实践

1. 工作空间隔离策略

为不同项目创建独立的工作空间：

# 为每个项目创建独立工作空间
openclaw workspace create project-frontend
openclaw workspace create project-backend
openclaw workspace create personal

# 根据当前项目切换工作空间
openclaw workspace switch project-frontend

2. Skills 管理策略

• 核心 Skills 安装在全局：clawhub install -g <skill-name>
• 项目专属 Skills 安装在工作区：clawhub install <skill-name>
• 定期清理未使用的 Skills：openclaw skills list --unused
• 保持 Skills 更新：clawhub update --all

3. 配置管理策略

使用配置分层：

• 全局配置：~/.openclaw/openclaw.json（基础配置）
• 工作区配置：<workspace>/openclaw.json（项目专属配置）
• 环境变量：.env 文件（敏感信息）

4. 安全管理策略

• API 密钥存储在凭证目录：~/.openclaw/credentials/
• 定期审计安全配置：openclaw security audit --deep
• 限制网关绑定地址："bind": "localhost"（开发环境）或 "bind": "lan"（内网）
• 使用 HTTPS 和认证：生产环境必须启用

5. 性能优化策略

{
  "performance": {
    // 限制上下文长度
    "maxContextTokens": 8000,
    
    // 启用流式响应
    "streaming": true,
    
    // 缓存配置
    "cache": {
      "enabled": true,
      "ttl": 3600
    },
    
    // 并发限制
    "concurrency": {
      "maxRequests": 10,
      "queueSize": 100
    }
  }
}

6. 备份和恢复策略

# 备份配置和记忆
openclaw config export > config-backup.json
openclaw memory export > memory-backup.json
openclaw workspace export default > workspace-backup.json

# 备份 Skills
cp -r ~/.openclaw/skills ./skills-backup
cp -r ./skills ./skills-backup

# 恢复
cp config-backup.json ~/.openclaw/openclaw.json
openclaw memory import < memory-backup.json
openclaw workspace import < workspace-backup.json

7. 团队协作策略

• 共享工作区模板：创建标准工作区并导出
• 版本控制 Skills：将工作区 Skills 纳入 Git 管理
• 统一配置规范：团队使用相同的配置文件模板
• 文档化最佳实践：记录团队专属的使用规范

---

常见问题

Q1: Skills 安装后无法使用？

可能原因：

1. Skills 加载优先级冲突
2. 缺少依赖（os/binaries）
3. 配置未正确加载

解决方案：

# 1. 检查 Skills 是否加载
openclaw skills list | grep <skill-name>

# 2. 检查依赖
openclaw skills check <skill-name>

# 3. 重新加载 Skills
openclaw skills reload

# 4. 查看日志定位问题
openclaw logs --level error

Q2: 如何切换模型提供商？

# 查看可用模型
openclaw models list

# 设置默认模型
openclaw models set gpt-4o

# 在对话中临时切换（取决于 Skill 支持）

Q3: 记忆内容过多导致性能下降？

# 清理旧记忆
openclaw memory clear --before 30d

# 优化记忆配置
openclaw config set memory.maxItems 500
openclaw config set memory.retentionDays 14

# 导出重要记忆后清空
openclaw memory export > important-memories.json
openclaw memory clear

Q4: 网关无法启动？

# 检查端口占用
lsof -i :3000

# 更改端口
openclaw config set gateway.port 3001

# 查看详细错误
openclaw gateway logs

Q5: 如何迁移到另一台服务器？

# 在原服务器上打包
tar -czf openclaw-backup.tar.gz ~/.openclaw

# 传输到新服务器
scp openclaw-backup.tar.gz user@new-server:~/

# 在新服务器上解压
tar -xzf openclaw-backup.tar.gz -C ~/

# 重新安装依赖
openclaw doctor

Q6: Skills 安装慢或失败？

# 更换 ClawHub 镜像源
openclaw config set skills.registry https://clawhub.cn

# 使用代理
export HTTPS_PROXY=http://proxy.example.com:8080

# 手动下载安装
git clone https://github.com/user/skill-name.git ~/.openclaw/skills/skill-name
openclaw skills reload

Q7: 如何实现多用户隔离？

解决方案：

1. 为每个用户创建独立的工作空间
2. 使用 Docker 容器隔离
3. 配置独立的网关实例
4. 使用权限管理插件

# 创建用户专属工作空间
openclaw workspace create user-$(whoami)
openclaw workspace switch user-$(whoami)

Q8: 日志文件过大？

# 自动清理旧日志
openclaw logs clear --before 7d

# 配置日志轮转
openclaw config set logs.maxSize 100MB
openclaw config set logs.maxFiles 10

# 手动清理
rm ~/.openclaw/logs/*.log

---

进阶技巧

自定义 Skill 开发

# 1. 创建 Skill 骨架
openclaw skills create my-skill

# 2. 编辑 SKILL.md
cd ~/.openclaw/skills/my-skill
nano SKILL.md

# 3. 添加脚本
mkdir scripts
echo '#!/bin/bash\necho "Hello from my skill"' > scripts/hello.sh
chmod +x scripts/hello.sh

# 4. 测试 Skill
openclaw skills test my-skill

# 5. 发布到 ClawHub（可选）
clawhub publish my-skill

集成 CI/CD

# .github/workflows/openclaw.yml
name: OpenClaw Integration

on: [push]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3
      
      - name: Setup OpenClaw
        run: |
          curl -fsSL https://openclaw.ai/install.sh | sh
          openclaw skills install code-assistant
          
      - name: Run Tests
        run: |
          openclaw --workspace ci run-tests
          
      - name: Generate Report
        run: |
          openclaw --workspace ci generate-report

API 集成

// 使用 OpenClaw API
const OpenClaw = require('openclaw-sdk');

const client = new OpenClaw({
  baseUrl: 'http://localhost:3000',
  apiKey: 'your-api-key'
});

// 发送消息
const response = await client.chat({
  message: '分析这段代码',
  workspace: 'project-a',
  skills: ['code-assistant']
});

console.log(response.content);

---

社区资源

• 官方文档: docs.openclaw.ai
• ClawHub: clawhub.ai
• GitHub: github.com/openclaw/op…
• 社区论坛: forum.openclaw.ai
• Discord: discord.gg/openclaw

---

总结

OpenClaw 是一个功能强大的 AI Agent 平台，其核心价值在于：

1. 模块化扩展：通过 Skills 系统实现功能无限扩展
2. 工作空间隔离：支持多项目、多场景独立管理
3. 任务自动化：提供丰富的任务管理和自动化能力
4. 社区生态：庞大的 ClawHub 市场提供 9000+ 可用 Skills
5. 自托管：数据完全掌控，满足安全和合规要求

通过本指南，你应该已经掌握了 OpenClaw 的核心使用方法。建议从安装基础 Skills 开始，逐步探索更高级的功能，并根据实际需求定制专属的工作流程。

---