OpenClaw 完整安装指南OpenClaw 完整安装指南本文档提供 OpenClaw 的详细安装步骤、技能配置和使

OpenClaw 完整安装指南

本文档提供 OpenClaw 的详细安装步骤、技能配置和使用指南，帮助你快速搭建和优化 AI 助手。

一、环境准备

1. 系统要求

Windows：Windows 10 21H2+ 或 Windows 11（需启用 WSL2）
macOS：macOS 10.15+
Linux：Ubuntu 20.04+ 或 CentOS 8+

2. 硬件要求

内存：≥ 8GB（推荐 16GB）
硬盘：≥ 20GB 剩余空间
CPU：支持虚拟化（Windows 需在 BIOS 中开启）

3. 软件依赖

Node.js

OpenClaw 要求 Node.js 版本 ≥ 22.0.0：

# 检查 Node.js 版本
node -v

# 若版本过低，安装或升级 Node.js
# 方法 1：从官网下载安装
# 方法 2：使用 nvm（推荐）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 22
nvm use 22

Windows 特殊要求

Windows 用户需启用 WSL2：

# 以管理员身份运行 PowerShell
wsl --install

# 验证 WSL2 安装
wsl -l -v

二、OpenClaw 安装

1. 方法一：npm 全局安装（推荐）

# 全局安装 OpenClaw
npm install -g openclaw@latest

# 验证安装
openclaw --version

2. 方法二：PowerShell 安装器脚本（Windows 专用）

# 以管理员身份运行 PowerShell
iwr -useb https://openclaw.ai/install.ps1 | iex

3. 方法三：源码编译安装（开发者）

git clone https://github.com/openclaw/openclaw.git
cd openclaw
npm install
npm run build
openclaw onboard --install-daemon

三、初始化配置

1. 运行初始化向导

# 启动初始化向导并安装后台服务
openclaw onboard --install-daemon

配置流程：

选择安装方式：默认选择 npm
配置 AI 模型：
- 云端模型：输入 API Key（如 MiniMax、OpenAI、Anthropic 等）
- 本地模型：安装 Ollama 后选择本地模型
设置网关端口：默认 18789
安装后台服务：选择是，实现开机自启

2. 启动网关服务

# 启动网关服务
openclaw gateway start

# 查看服务状态
openclaw gateway status

# 重启网关（配置变更后）
openclaw gateway restart

3. 访问 Web 控制面板

# 启动控制面板
openclaw dashboard

浏览器会自动打开：http://127.0.0.1:18789/

四、技能（Skills）配置

1. 核心技能安装

# 安装代码执行技能
openclaw skills install code-executor

# 安装文件管理技能
openclaw skills install file-manager

# 安装浏览器控制技能
openclaw skills install web-browser

# 安装 Git 操作技能
openclaw skills install git

# 安装终端控制技能
openclaw skills install terminal

# 安装文档处理技能
openclaw skills install document-processor

# 安装邮件管理技能
openclaw skills install email

# 安装日历管理技能
openclaw skills install calendar

# 安装笔记管理技能
openclaw skills install note-taker

# 安装对话优化技能
openclaw skills install conversation

# 安装翻译技能
openclaw skills install translation

# 安装文本总结技能
openclaw skills install summarizer

2. 实用技能安装

# 安装 ClawHub（技能市场，可发现更多技能）
openclaw skills install clawhub

# 安装自我进化技能（自动优化模型选择和执行策略）
openclaw skills install self-evolution

# 安装 Office 文件处理技能（Word、Excel、PowerPoint）
openclaw skills install office-processor

# 安装 ClawHub 热门技能
# 代码生成与优化
openclaw skills install code-generator
# 数据分析与可视化
openclaw skills install data-analyzer
# 网络爬虫
openclaw skills install web-scraper
# 语音转文字
openclaw skills install speech-to-text
# 文字转语音
openclaw skills install text-to-speech

3. 技能管理

# 查看已安装技能
openclaw skills list

# 更新技能
openclaw skills update <skill-name>

# 卸载技能
openclaw skills uninstall <skill-name>

# 启用/禁用技能
openclaw skills enable <skill-name>
openclaw skills disable <skill-name>

4. 技能配置建议

技能类别	推荐技能	适用场景
开发工具	code-executor, git, terminal	代码开发、版本控制
文件管理	file-manager, document-processor	文档处理、文件操作
信息获取	web-browser, summarizer	网页浏览、信息提取
日常办公	email, calendar, note-taker	邮件管理、日程安排
交互优化	conversation, translation	多语言交流、对话优化

五、模型配置

1. 云端模型配置

通过 Web 控制面板配置：

进入「模型设置」页面
添加模型提供商（如 MiniMax、OpenAI、Anthropic 等）
输入 API Key 并保存

通过配置文件配置：
编辑配置文件 ~/.openclaw/openclaw.json：

{
  "models": {
    "mode": "merge",
    "providers": {
      "minimax": {
        "baseUrl": "https://api.minimax.chat/v1",
        "api": "minimax-chat",
        "models": [
          {
            "id": "minimax-2.5",
            "name": "MiniMax 2.5",
            "contextWindow": 128000,
            "maxTokens": 8192
          }
        ]
      }
    }
  }
}

2. 本地模型配置

安装 Ollama：

下载并安装 Ollama：ollama.com/

拉取模型：

ollama pull qwen:7b
ollama pull llama3:8b

配置 OpenClaw 连接 Ollama：
在初始化向导中选择 Ollama，自动完成配置。

六、平台接入

1. 飞书接入

步骤 1：创建飞书应用

登录飞书开放平台：open.feishu.cn/
点击「创建企业自建应用」
填写应用名称（如「我的AI助手」）和描述
提交创建后，进入应用详情页
在「凭证与基础信息」页面，复制 App ID 和 App Secret（保存备用）

步骤 2：配置飞书应用

开启机器人能力：
- 进入「应用能力」→「机器人」
- 开启机器人能力，设置机器人名称和头像
配置事件订阅：
- 进入「事件订阅」
- 选择「使用长连接接收事件」（WebSocket模式）
- 添加事件 im.message.receive_v1

配置权限：

进入「权限管理」
点击「批量导入」，粘贴以下权限配置：

{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application:self_manage",
      "application:bot.menu:write",
      "cardkit:card:write",
      "contact:user.employee_id:readonly",
      "docs:document.content:read",
      "im:chat",
      "im:message",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource"
    ],
    "user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]
  }
}

发布应用：
- 进入「版本管理与发布」
- 创建版本，提交发布（企业自建应用自动通过，无需审核）

步骤 3：OpenClaw 配置

# 安装飞书插件
openclaw plugins install @openclaw/feishu

# 添加飞书渠道
openclaw channels add
# 按照提示选择 Feishu，输入 App ID 和 App Secret

# 重启网关
openclaw gateway restart

步骤 4：授权配对

在飞书中搜索你创建的机器人，发送消息（如「你好」）
机器人会回复一个配对码

在终端输入授权命令：

openclaw pairing approve feishu <配对码>

再次向机器人发送消息，测试是否正常回复

2. Telegram 接入

步骤 1：创建 Telegram Bot

在 Telegram 中搜索 @BotFather
发送 /newbot 命令
按照提示输入机器人名称和用户名（用户名必须以 _bot 结尾）
BotFather 会提供一个 Bot Token（保存备用）

步骤 2：安装 Telegram 插件

# 安装 Telegram 插件
openclaw plugins install @openclaw/telegram

步骤 3：配置 Telegram 渠道

# 添加 Telegram 渠道
openclaw channels add
# 按照提示选择 Telegram，输入 Bot Token

步骤 4：配置本地代理（重要）
由于 Telegram 在国内无法直接访问，需要配置本地代理：

在 OpenClaw 配置文件中设置代理：
编辑 ~/.openclaw/openclaw.json 文件，添加代理配置：

{
  "proxy": {
    "enabled": true,
    "type": "socks5",
    "host": "127.0.0.1",
    "port": 10808
  }
}

确保代理服务运行：
- 确保你的代理软件（如 Shadowsocks、V2Ray 等）正在运行
- 代理端口与配置文件中的端口一致

步骤 5：重启网关并测试

# 重启网关
openclaw gateway restart

# 在 Telegram 中向机器人发送消息，测试是否正常回复

七、常见问题排查

1. 安装失败

Node.js 版本过低：升级到 Node.js 22+ 版本
权限不足：使用管理员权限运行命令
网络问题：检查网络连接，切换 npm 源

依赖冲突：清理 npm 缓存后重新安装

npm cache clean --force
npm install -g openclaw@latest

2. 模型调用失败

API Key 错误：检查 API Key 是否正确，注意大小写
模型权限：确保账号有对应模型的访问权限
网络限制：对于海外模型，配置本地代理
API 额度不足：检查模型提供商的 API 额度
模型服务维护：查看模型提供商的服务状态

3. 技能安装失败

依赖缺失：运行 openclaw doctor 检查环境
版本冲突：卸载冲突技能后重新安装
网络问题：检查网络连接，确保能访问技能仓库
权限问题：确保有足够权限写入技能目录

4. 网关启动失败

端口占用：修改网关端口（默认 18789）
```
openclaw gateway start --port 18790
```
权限问题：确保有足够权限启动服务
配置错误：检查配置文件是否有语法错误
服务冲突：停止其他占用相同端口的服务

5. 平台接入问题

飞书授权失败：
- 检查 App ID 和 App Secret 是否正确
- 确保应用已发布并获得权限
- 检查网络连接是否正常
Telegram 连接失败：
- 确保 Bot Token 有效且未过期
- 配置正确的本地代理
- 检查防火墙是否阻止连接

6. 异常行为处理

不停回复同一句话：
- 重启网关服务：openclaw gateway restart
- 清除对话缓存：openclaw cache clear
- 检查模型配置是否正确
- 禁用并重新启用相关技能
响应缓慢：
- 选择响应速度更快的模型
- 关闭不常用的技能
- 增加网关的内存分配
执行错误：
- 检查技能权限是否正确
- 确保文件路径和命令正确
- 查看网关日志：openclaw gateway logs

7. 飞书机器人创建常见问题

无法创建应用：确保飞书账号有创建应用的权限
权限配置错误：按照文档正确配置权限，特别是 im:message:send_as_bot
事件订阅失败：确保选择了正确的事件类型 im.message.receive_v1
配对码不显示：检查网络连接，确保 OpenClaw 能正常访问飞书 API
duplicate plugin id detected：
- 原因：飞书插件 ID 重复，可能是因为之前已安装过飞书插件
- 解决方案：
  1. 卸载已有的飞书插件：
```
openclaw plugins uninstall @openclaw/feishu
```
  2. 清理插件缓存：
```
openclaw cache clear
```
  3. 重新安装飞书插件：
```
openclaw plugins install @openclaw/feishu
```
  4. 重启网关：
```
openclaw gateway restart
```

8. Telegram 代理配置问题

代理类型错误：根据你的代理软件选择正确的代理类型（socks5 或 http）
端口配置错误：确保配置文件中的端口与代理软件一致
代理服务未运行：启动代理软件并确保其正常运行
防火墙阻止：检查防火墙是否允许 OpenClaw 访问代理端口

八、优化建议

1. 性能优化

关闭不常用技能：减少系统资源占用
选择合适模型：根据任务复杂度选择模型
调整缓存设置：增加缓存大小提升响应速度

2. 安全优化

权限管理：仅授权必要的技能权限
隐私保护：敏感任务使用本地模型
定期更新：及时更新 OpenClaw 和技能版本

3. 使用技巧

明确指令：提供具体上下文和期望结果
任务分解：复杂任务拆分为多个子任务
反馈学习：对输出进行评价，帮助模型优化

九、命令速查

命令	功能
`openclaw --version`	查看版本
`openclaw onboard`	初始化配置
`openclaw gateway start`	启动网关
`openclaw dashboard`	启动控制面板
`openclaw tui`	终端交互模式
`openclaw skills install <skill>`	安装技能
`openclaw skills list`	查看已安装技能
`openclaw doctor`	检查环境
`openclaw status`	查看服务状态

十、资源链接

官方文档：openclaw.ai/docs
GitHub 仓库：github.com/openclaw/op…
技能市场：openclaw.ai/skills
社区论坛：community.openclaw.ai

安装完成后，你可以通过 openclaw tui 进入终端交互模式，或通过 Web 控制面板开始使用 OpenClaw。根据你的需求安装相应技能，配置合适的模型，即可享受 AI 助手带来的高效体验！

十一、MiniMax 2.5 CodingPlan 配置文件示例

1. 主配置文件（openclaw.json）

{
  "agents": {
    "defaults": {
      "workspace": "C:\Users\YourUsername\clawd",
      "models": {
        "minimax/minimax-2.5": {
          "alias": "MiniMax 2.5"
        }
      },
      "model": {
        "primary": "minimax/minimax-2.5"
      }
    }
  },
  "auth": {
    "profiles": {
      "minimax:default": {
        "provider": "minimax",
        "mode": "api_key"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "minimax": {
        "baseUrl": "https://api.minimax.chat/v1",
        "api": "minimax-chat",
        "models": [
          {
            "id": "minimax-2.5",
            "name": "MiniMax 2.5",
            "contextWindow": 128000,
            "maxTokens": 8192
          }
        ]
      }
    }
  },
  "proxy": {
    "enabled": true,
    "type": "socks5",
    "host": "127.0.0.1",
    "port": 10808
  },
  "skills": {
    "enabled": true,
    "autoUpdate": true
  }
}

2. 鉴权配置文件（auth-profiles.json）

{
  "version": 1,
  "profiles": {
    "minimax:default": {
      "type": "api_key",
      "provider": "minimax",
      "key": "YourMiniMaxAPIKeyHere"
    }
  }
}

3. 飞书插件配置

{
  "feishu": {
    "appId": "YourFeishuAppId",
    "appSecret": "YourFeishuAppSecret",
    "encodingAesKey": "",
    "token": "",
    "bot": {
      "name": "我的AI助手",
      "avatar": ""
    },
    "events": {
      "message": true,
      "chat": true
    }
  }
}

4. 机器人个性配置（prompt）

{
  "system": "你是一个智能AI助手，名为OpenClaw。你的核心原则是：\n\n1. 认真做事，别敷衍。少说客套话，直接动手解决问题。\n2. 有自己的想法，可以不同意用户的观点，提供专业建议。\n3. 先自己想办法解决问题，实在搞不定再询问用户。\n4. 尊重用户隐私，不泄露敏感信息。\n5. 保持友好但专业的语气，像靠谱的同事一样交流。\n\n你的能力包括：代码生成、文件管理、网页浏览、文档处理等。你可以执行系统命令、访问网络、处理文件，但需要在安全范围内操作。\n\n记住，你不是简单的聊天机器人，而是一个有能力、有个性的AI助手。",
  "personality": {
    "name": "OpenClaw",
    "age": "未知",
    "occupation": "AI助手",
    "hobbies": ["编程", "阅读", "解决问题"],
    "language": "中文",
    "tone": "专业友好",
    "responseStyle": "简洁明了"
  }
}

5. 技能配置示例

{
  "skills": {
    "code-executor": {
      "enabled": true,
      "timeout": 30,
      "maxOutput": 10000
    },
    "file-manager": {
      "enabled": true,
      "allowedPaths": ["~", "D:\Projects"],
      "deniedPaths": ["C:\Windows"]
    },
    "web-browser": {
      "enabled": true,
      "maxTabs": 5,
      "timeout": 60
    },
    "self-evolution": {
      "enabled": true,
      "learningRate": 0.1,
      "maxMemory": 10000
    }
  }
}

6. 网关配置

{
  "gateway": {
    "port": 18789,
    "host": "127.0.0.1",
    "ssl": false,
    "maxConnections": 100,
    "timeout": 300,
    "memoryLimit": "2GB",
    "logLevel": "info"
  }
}