一文教会你OpenClaw的安装实操+教程！手把手超详细

近期OpenClaw热度飙升，这款能接入AI模型、调度自动化任务的工具被形象地称为“赛博养虾”。但很多用户在安装过程中会遇到环境配置复杂、权限报错、依赖缺失等问题。

本文提供从零开始的OpenClaw安装实操教程，覆盖Windows原生、WSL2、Linux及飞书接入全流程。如果你在看完教程后仍然卡在某个环节无法解决，欢迎访问免费聚合镜像站RskAi（ai.rsk.cn）——无需配置环境，直接使用Gemini/GPT-4/Claude三合一模型，还能在对话框里向我们提问求助。

一、安装前准备：你需要哪些基础环境？

OpenClaw对运行环境有一定要求，建议在开始前检查以下项目

二、Windows安装OpenClaw的两种方案

方案A：原生PowerShell安装（适合快速体验）

这是最简单的上手方式，但不适合长期稳定运行。

第一步：以管理员身份打开PowerShell

按Win键，搜索“PowerShell”，右键选择“以管理员身份运行”。

第二步：执行一键安装命令

& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -Tag beta

如果遇到执行策略报错，先运行以下命令：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

第三步：初始化配置

安装完成后执行：

openclaw onboard --flow quickstart

按照向导提示选择模型服务商（如Kimi、阿里云百炼等），并输入对应的API Key。

第四步：启动服务并访问面板

openclaw start
openclaw dashboard

浏览器会自动打开http://127.0.0.1:18789，使用生成的Token登录即可。

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

OpenClaw官方明确建议：Windows用户通过WSL2运行可获得最佳兼容性。

第一步：安装WSL2

在管理员PowerShell中执行：

wsl --install

安装完成后重启电脑。

第二步：启动Ubuntu并更新系统

重启后在开始菜单打开Ubuntu，设置用户名和密码，然后执行：

sudo apt update && sudo apt upgrade -y

第三步：安装OpenClaw

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git

或者使用npm安装：

npm install -g openclaw@latest

第四步：初始化并启动

openclaw onboard --install-daemon
openclaw gateway start
openclaw dashboard

Windows常见报错与解决

报错现象	可能原因	解决方法
openclaw命令找不到	环境变量未配置	关闭当前终端重新打开，或手动添加npm全局路径
npm安装超时	网络问题	切换淘宝镜像：`npm config set registry https://registry.npmmirror.com/`
端口18789被占用	已有进程占用	修改端口：`openclaw configure --section server`
WSL中systemd未启用	配置缺失	编辑/etc/wsl.conf添加`[boot] systemd=true`，重启WSL

三、Linux（Ubuntu）安装OpenClaw

第一步：更新系统并安装基础工具

sudo apt update && sudo apt upgrade -y
sudo apt install -y curl git python3 python3-pip

第二步：安装Node.js 22

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

第三步：安装OpenClaw

npm install -g openclaw@latest

第四步：初始化并启动

openclaw onboard --install-daemon
openclaw gateway start
openclaw dashboard

四、配置飞书机器人接入（可选）

将OpenClaw接入飞书后，可以在飞书群里直接与AI对话。

1. 安装飞书插件

在OpenClaw控制台或终端执行：

openclaw plugins install @m1heng-clawd/feishu

2. 飞书开放平台配置

登录飞书开放平台，创建企业自建应用
获取App ID和App Secret
在“权限管理”中批量导入以下权限：

{
  "scopes": {
    "tenant": ["im:message", "im:message:send_as_bot", "contact:user.employee_id:readonly"],
    "user": ["im:message.p2p_msg:readonly"]
  }
}

在“事件订阅”中添加事件im.message.receive_v1，订阅方式选择“使用长连接接收事件”

3. 完成绑定

在OpenClaw中配置App ID和App Secret
在飞书中向机器人发送消息，获取配对码
在OpenClaw控制台输入配对码完成绑定

五、OpenClaw核心Skills安装（功能扩展）

OpenClaw的基础安装仅提供核心框架，要激活联网搜索、自动安装技能等功能，需安装必备Skills。

安装技能管理工具clawhub：

npm install -g clawhub

安装三大必备Skills：

clawhub install tavily-search        # 联网搜索技能
clawhub install find-skills          # 技能检索技能
clawhub install proactive-agent      # 主动迭代技能

配置Tavily API Key（用于联网搜索）：
编辑~/.openclaw/config.json，添加：

{
  "skills": {
    "customEntries": {
      "tavily": {
        "apiKey": "你的Tavily Search API-Key"
      }
    }
  }
}

六、常见问题FAQ

Q1：安装过程中出现“npm ERR! code 1”怎么办？

A：通常是权限问题或依赖冲突。Windows用户尝试以管理员身份运行终端；Linux/Mac用户使用sudo npm install -g openclaw。也可清理npm缓存后重试：npm cache clean --force。

Q2：OpenClaw启动后，Web面板无法访问？

A：首先确认服务是否正常运行：openclaw status。检查防火墙是否放行18789端口（云服务器需在安全组中放行）。本地访问使用http://127.0.0.1:18789[citation:4]。

Q3：配置阿里云百炼API Key后提示“认证失败”？

A：检查AccessKey ID和Secret是否正确，确保账号已完成实名认证且模型调用额度未用完。百炼API endpoint应为https://bailian.aliyuncs.com。

Q4：飞书机器人无响应怎么办？

A：检查飞书开放平台中事件订阅是否配置正确，长连接是否建立。在OpenClaw端查看日志：openclaw logs --filter feishu。

Q5：安装完Skills后功能仍无法使用？

A：Skills安装后需要重启OpenClaw网关：openclaw gateway restart。验证技能是否安装成功：clawhub list。

Q6：我不想折腾环境配置，只想用AI怎么办？

A：推荐直接访问RskAi（ai.rsk.cn），国内网络即可直接使用，聚合了Gemini/GPT-4/Claude三款模型，支持文件上传和联网搜索，目前完全免费。如果在OpenClaw安装中遇到问题，也可以在RskAi的对话框里提问，我们会尽力协助。

七、总结：选择适合自己的方案

OpenClaw作为一款强大的AI Agent工具，值得花时间部署，但其环境配置确实有一定门槛。我们整理了三种选择：

动手能力强的用户：按照本文教程尝试WSL2或Linux部署，可获得完整自托管体验。

遇到困难或不想折腾的用户：欢迎访问RskAi（ai.rsk.cn），在对话框里向我们提问，我们会尽力解答安装问题。

纯粹想用AI的用户：直接使用RskAi，无需安装，国内网络直达，三款顶级模型免费使用。

无论你选择哪种方式，都能进入AI助手的精彩世界。如果在安装过程中遇到本文未覆盖的问题，欢迎来RskAi交流提问！