OpenClaw 开源 AI 智能体本地部署与使用教程

OpenClaw 简介

OpenClaw 是一款运行在本地环境的高权限 AI 智能体。其核心特性包括：

• 本地部署：运行在你的服务器或电脑上，数据完全自主可控。
• 多平台支持：支持飞书、WhatsApp、Telegram、Discord、Slack 等主流聊天工具。
• 浏览器控制：可以浏览网页、填写表单、提取数据。
• 系统访问：读写文件、执行 Shell 命令、运行脚本。
• 持久化记忆：记住你的偏好和上下文，成为真正属于你的 AI。
• 插件扩展：支持社区技能插件，甚至可以自己编写插件。

无论是邮件管理、日程安排、数据查询还是代码编写，OpenClaw 都能成为你的得力助手。

官网地址：https://github.com/openclaw/openclaw 官网文档：https://docs.openclaw.ai/zh-CN/gateway

一、核心能力

1. 网页全自动化：自动打开浏览器，查资料、爬数据、监控价格、管理邮箱。
2. 电脑全能操控：帮你安装软件、编写程序、监控后台任务，整理本地文件。
3. 7×24 小时不间断工作：你睡前丢给它一个任务，第二天醒来它已经干完等你审核。
4. 向量记忆越用越懂你：自带记忆模块，会记录你的使用习惯、任务偏好。

它能部署在 Windows、Mac、Linux 任意电脑上，消耗的是自己电脑的资源，永久免费使用。

二、部署前准备

1. 模型 API 配置

OpenClaw 需要对接大模型的 API 才能运转。国内主流厂商都有包月套餐，成本较低。

推荐模型厂商（仅供参考）：

• 智谱 GLM5.0：适合编程、数据分析、复杂办公。
• 阿里通义：轻量体验性价比之王。
• 字节豆包：兼顾性价比 + 飞书联动。
• Kimi：理解能力强，适合日常办公、内容创作。

请前往对应厂商官网获取 API Key。

2. 环境要求

确保已安装 Node.js (建议 v22+) 和 Git。

三、安装步骤

第一步：一键安装

打开电脑的终端/命令提示符，直接复制对应系统的命令执行。

🖥️ Mac/Linux 用户

curl -fsSL https://clawd.org.cn/install.sh | bash -s -- --registry https://registry.npmmirror.com 

🖥️ Windows 用户

iwr -useb https://clawd.org.cn/install.ps1 -OutFile install.ps1; ./install.ps1 -Registry https://registry.npmmirror.com 

如果一键安装失败，可参考以下手动安装流程：

1. 安装 Git

sudo yum update
sudo yum install git -y

2. 安装 NVM

# 国内使用 gitee 的镜像源
curl -o- https://gitee.com/RubyMetric/nvm-cn/raw/main/install.sh | bash
# 如果卡住了先清理
rm -rf /root/.nvm
export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node
curl -o- https://gitee.com/mirrors/nvm/raw/master/install.sh | bash

# 国外使用
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash

3. 重新加载环境变量

source ~/.bashrc

4. 安装 Node.js 22

nvm install 22
node -v # 输出 v22 即可

5. 使用官方脚本安装 OpenClaw

curl -fsSL https://openclaw.bot/install.sh | bash

第二步：安全确认

安装过程中会出现安全警告界面，需明确授权。

安全警告 - 请阅读。
OpenClaw 是一个业余项目，仍处于测试阶段...
我理解这很强大且本质上存在风险。继续吗？
○ Yes / ● No

操作步骤：

1. 按键盘 → 右键把光标从 ● No 移到 ○ Yes。
2. 按 回车键 Enter。

第三步：配置向导

确认安全警告后，安装程序会继续引导配置：

步骤	操作	新手建议
1. 配置模式	QuickStart vs Manual	选 QuickStart
2. 模型选择	提供商选择	选 Skip for now（稍后再配）
3. 聊天渠道	Telegram/飞书等	选 Skip for now（先用 Web 界面）
4. 技能配置	安装基础功能包	选 Yes
5. 包管理器	npm/pnpm	选 npm
6. 记忆功能	安装 Hooks	选中 session-memory 和 boot-md
7. 启动方式	如何启动助手	选 Do this later

若遇到界面卡住，可按 Ctrl+C 中断，然后手动启动配置向导：

openclaw onboard

查看安装状态：

openclaw --version
openclaw doctor

四、配置模型

安装完成后，执行命令配置 API 密钥。以阿里云百炼为例：

# 设置提供商
openclaw config set provider dashscope
# 设置 API 密钥
openclaw config set apiKey sk-你的 API 密钥
# 设置模型名称
openclaw config set model qwen-max

API 密钥获取方式：

1. 登录阿里云百炼控制台。
2. 进入'模型广场' → 'API-KEY 管理'。
3. 创建新的 API Key，复制以 sk- 开头的密钥。

验证配置：

openclaw config list

五、启动与访问

方法一：直接启动网关

openclaw gateway
# 或者后台运行
nohup openclaw gateway > openclaw.log 2>&1 &

方法二：SSH 端口转发（推荐）

如果你是在服务器上安装的，需要用 SSH 端口转发从本地访问。

在本地电脑（Windows/Mac）上执行：

ssh -N -L 18790:127.0.0.1:18789 root@[服务器 IP]

输入服务器密码后，保持窗口开着。

然后打开浏览器访问：

http://[服务器 IP]:18790/?token=[token]

注意：配置文件中的 bind 默认为 loopback (127.0.0.1)，必须通过 SSH 隧道访问。如需允许局域网访问，可将 bind 改为 lan，但需注意安全风险。

六、核心技能 (Skills)

给 OpenClaw 装上核心技能，提升能力：

• self-improvement：自我改进神器，自动记录错误、总结经验。
• browser：浏览器自动化核心，网页交互、截图、数据爬取。
• desktop-control：桌面操控大师，鼠标、键盘、软件操作自动化。
• auto-updater：自动更新，实时同步技能。
• skill-vetter：安全防护盾，扫描安装的技能是否有风险。
• subagent-driven-development：智能管理者，委派复杂任务。
• vector-memory：记忆优化器，解决上下文杂乱问题。
• clawhub：技能应用市场，检索安装所需功能。

七、安全提醒

OpenClaw 能操控你的电脑，请务必做好安全防护：

1. 关闭默认无密码端口：很多用户暴露默认端口，容易被黑客入侵，一定要设置密码。
2. 谨慎授予高权限：不要让它随意操作系统文件夹、重要工作文件。
3. 只装正规技能：通过 clawhub 或官方渠道安装技能，避免恶意技能泄露数据。
4. 把它当'实习生'：执行力强但阅历浅，复杂重要的任务，一定要自己审核结果。

八、学习资源

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

---

本文旨在提供技术参考，请在合法合规的前提下使用。