OpenClaw（曾用名Clawdbot、Moltbot）是2026年初爆火的开源AI智能体框架，它不仅仅是一个对话AI，更是一个能真正“动手”帮你操作电脑、处理任务的数字管家。本文将为你提供最详细的OpenClaw安装配置教程，涵盖Windows、macOS和Linux三大平台，适合初学者快速上手。

一、OpenClaw是什么？

OpenClaw是一个开源的个人AI智能体框架，其核心定位是基于大语言模型的自动化执行器。与传统AI助手不同，OpenClaw具备真正的“代理权”，能够直接操作你的文件系统、浏览器、应用程序等，实现从“动口”到“动手”的转变。

核心特点：

  • 本地优先：数据不上传云端，保护隐私安全
  • 开源免费：基于MIT协议，社区活跃
  • 持续在线：7x24小时后台运行
  • 低门槛：自然语言指令，无需编程基础

二、环境准备

2.1 系统要求

  • 操作系统：Windows 10/11（64位）、macOS 10.15+、Linux（Ubuntu 20.04+）
  • 内存：≥4GB（推荐8GB+）
  • 磁盘空间：≥5GB
  • 网络：稳定互联网连接

2.2 软件依赖

  • Node.js：版本≥22（安装脚本会自动检测并安装）
  • Git：用于拉取代码和依赖（Windows用户可能需要手动安装）

三、安装OpenClaw

3.1 Windows系统安装（三种方案）

方案一：一键脚本安装（推荐给新手）

这是最简单快捷的方式，适合快速体验：

  1. 以管理员身份打开PowerShell

    • 按Win+X，选择“Windows PowerShell（管理员）”
    • 或搜索PowerShell，右键选择“以管理员身份运行”

  2. 解锁执行策略（如遇报错）

    Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

    输入Y确认

  3. 执行一键安装命令

    iwr -useb https://openclaw.ai/install.ps1 | iex

    如果下载缓慢，可使用国内镜像：

    iwr -useb https://clawd.org.cn/install.ps1 | iex

    脚本会自动检查并安装所需环境

方案二：WSL2安装（官方推荐，稳定性最佳）

OpenClaw主要为类Unix环境设计，通过WSL2运行可获得最佳兼容性：

  1. 安装WSL2和Ubuntu

    wsl --install -d Ubuntu-22.04
wsl --set-default-version 2

    安装完成后重启电脑

  2. 进入WSL环境并安装

    • 重启后打开PowerShell，输入wsl进入Ubuntu
    • 执行Linux安装命令： 
      curl -fsSL https://openclaw.ai/install.sh | bash
方案三：npm手动安装（适合有技术基础）

如果已安装Node.js 22+，可手动安装：

npm install -g openclaw@latest

3.2 macOS/Linux系统安装

一键安装（推荐）
curl -fsSL https://openclaw.ai/install.sh | bash
npm安装
npm install -g openclaw@latest

3.3 验证安装

安装完成后，验证是否成功：

openclaw --version

出现版本号（如2026.3.x）即表示安装成功。

四、初始化配置

4.1 启动配置向导

执行以下命令启动交互式配置向导：

openclaw onboard --install-daemon

或使用快速启动模式：

openclaw onboard --flow quickstart

4.2 配置选项详解

向导会引导你完成以下配置：

配置项 选项 推荐选择 说明
模式选择 QuickStart/Advanced QuickStart 新手选QuickStart，自动配置基础参数
模型提供方 Qwen/OpenAI/Skip for now Qwen 国内用户选Qwen，可直接访问
默认模型 qwen-portal/coder-model 默认 保持默认即可
通道配置 Telegram/WhatsApp/Skip for now Skip for now 国内用户先跳过，后续配置飞书
技能配置 Yes/No Yes 启用基础功能模块
技能安装工具 npm/pnpm/bun npm 兼容性最好
API密钥配置 No/Yes No 国内用户先跳过

4.3 配置大模型API（可选但推荐）

OpenClaw需要连接大模型才能工作，以下是国内常用配置：

豆包API配置（国内首选）
# 配置默认提供商为豆包
openclaw config set --key llm.default.provider --value doubao

# 填入豆包Secret Key
openclaw config set --key llm.default.apiKey --value 你的豆包Secret Key

# 配置API地址
openclaw config set --key llm.default.baseUrl --value https://ark.cn-beijing.volces.com/api/v3

# 设置默认模型
openclaw config set --key llm.default.model --value doubao-pro
DeepSeek API配置
openclaw config set --key llm.default.provider --value deepseek
openclaw config set --key llm.default.apiKey --value 你的DeepSeek API密钥

五、启动与测试验证

5.1 启动网关服务

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

# 或以后台服务方式启动
openclaw daemon start

5.2 访问Web控制台

启动成功后，在浏览器中访问：

http://127.0.0.1:18789

或使用命令直接打开：

openclaw dashboard

5.3 系统状态检查

# 查看服务状态
openclaw gateway status

# 全面系统诊断
openclaw doctor

# 查看运行状态
openclaw status

# 测试API连通性
openclaw llm test --provider doubao

5.4 基础功能测试

  1. 文件操作测试：在Web控制台输入“帮我创建一个test.txt文件”
  2. 网页浏览测试：输入“打开百度首页”
  3. 信息查询测试：输入“今天的天气怎么样”

六、配置飞书通道（国内用户）

6.1 创建飞书应用

  1. 访问https://open.feishu.cn/app，创建“企业自建应用”
  2. 获取App ID和App Secret

6.2 配置OpenClaw

  1. 安装飞书插件

    openclaw plugins install @m1heng-clawd/feishu

  2. 编辑配置文件
    打开~/.openclaw/openclaw.json（Windows：C:\Users\用户名\.openclaw\openclaw.json），添加：

    "channels": {
  "feishu": {
    "enabled": true,
    "appId": "你的App ID",
    "appSecret": "你的App Secret",
    "connectionMode": "websocket"
  }
}

  3. 重启服务

    openclaw gateway restart

6.3 飞书权限配置

在飞书开放平台中：

  1. 权限管理：使用官方提供的JSON配置批量导入所需权限
  2. 事件与订阅：配置订阅方式为“使用长连接接收事件”
  3. 添加事件：添加im.message.receive_v1事件

七、常见问题与解决方案

7.1 安装问题

问题 解决方案
执行脚本提示“策略禁止运行脚本” Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
命令找不到openclaw 关闭所有终端重新打开，或手动添加PATH：%APPDATA%\npm
国内网络慢 切换npm镜像：npm config set registry https://registry.npmmirror.com
端口18789被占用 `netstat -ano

7.2 运行问题

问题 解决方案
Gateway启动失败 检查Node.js版本≥22，运行openclaw doctor诊断
API连接超时 检查网络代理设置，国内API无需代理
权限错误 不要使用root权限运行，修复目录权限：sudo chown -R $USER:$(id -gn) ~/.openclaw

7.3 配置问题

问题 解决方案
修改配置不生效 修改后必须重启服务：openclaw gateway restart
飞书连接失败 检查App ID/Secret，确认权限配置完整
模型无响应 检查API密钥是否正确，余额是否充足

八、安全注意事项

⚠️ 重要警告：OpenClaw拥有文件读写与命令执行权限，请务必谨慎使用。

  1. 权限最小化：不要使用root或管理员权限运行
  2. 严格审查：永远不要批准来源不明的Pairing请求
  3. 人工确认：默认情况下，危险操作（如删除文件）需要二次确认
  4. 环境隔离：建议在Docker或虚拟机中运行重要任务

九、进阶使用建议

9.1 技能扩展

OpenClaw通过ClawHub插件系统扩展功能，目前已拥有超过3000个功能扩展：

# 查看可用技能
openclaw skills list

# 安装技能
openclaw skills install 技能名称

9.2 自定义配置

高级用户可编辑配置文件~/.openclaw/openclaw.json，自定义：

  • 模型参数（温度、最大token数）
  • 安全策略（操作确认阈值）
  • 日志级别
  • 自定义技能路径

9.3 监控与维护

# 查看实时日志
openclaw logs follow

# 性能监控
openclaw metrics

# 备份配置
cp -r ~/.openclaw ~/.openclaw_backup

十、总结

OpenClaw作为一款革命性的AI智能体工具，将AI从“建议者”转变为“执行者”，显著提升了工作效率。通过本教程，你应该已经成功完成了OpenClaw的安装、配置和基础测试。

下一步建议：

  1. 从简单任务开始：先尝试文件整理、网页信息提取等基础任务
  2. 逐步增加复杂度：熟悉后尝试自动化工作流
  3. 探索社区资源：访问https://github.com/VoltAgent/awesome-openclaw-skills获取更多技能
  4. 参与贡献：OpenClaw是开源项目，欢迎提交Issue和PR

记住，OpenClaw不是全知全能的数字分身，而是一个需要你聪明引导的个人AI管家。合理使用，让它成为你工作和生活的得力助手！

官方资源：

  • 官网：https://openclaw.ai/
  • GitHub：https://github.com/openclaw/openclaw
  • 中文文档：https://docs.openclaw.ai/zh-CN
  • 中文社区：https://clawd.org.cn/

如果在安装过程中遇到问题，欢迎在评论区留言，我会尽力为你解答！

# 人工智能
Logo
AtomGit开源社区

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念，把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起，为开发者提供从开发、训练到部署的一站式体验。

更多推荐

cover

“教了一百遍，文件名还是中文”：OpenClaw四层防御让AI真正听劝

avatar AtomGit开源社区

DeepSpeed v0.18.9 正式发布！AutoTP 全面增强、ZeRO 与 SuperOffload 深度优化，大模型训练再升级

DeepSpeed v0.18.9作为一次迭代型版本更新，聚焦于功能增强、兼容性修复、稳定性提升、生态适配四大核心方向，所有变更均围绕大模型分布式训练的实际痛点展开，无破坏性变更，适合所有使用DeepSpeed的开发者升级。AutoTP能力全面升级，通用Checkpoint与HuggingFace tp_plan支持，大幅降低自动张量并行使用门槛；硬件与环境适配优化，支持自定义环境变量、多平台GP

avatar AtomGit开源社区
cover

基于SpringBoot+Vue的电影评论网站管理系统设计与实现【Java+MySQL+MyBatis完整源码】

avatar AtomGit开源社区