OpenClaw 本地部署与使用指南
最近，开源工具 OpenClaw 在技术圈受到广泛关注。它被称为'全能个人助理'，核心在于让 AI 从'只会聊天'变成'能实际干活'。
一、OpenClaw 核心能力
OpenClaw 是一个运行在本地环境的高权限 AI 智能体，支持 Windows、Mac、Linux 任意电脑，消耗本地资源，永久免费使用。
- 网页全自动化：自动打开浏览器，查资料、爬数据、监控价格、管理邮箱。
- 电脑全能操控：安装软件、编写程序、监控后台任务、整理本地文件。
- 7×24 小时不间断工作：睡前丢任务，醒来审核结果。
- 向量记忆越用越懂你：记录使用习惯和任务偏好，贴合需求。
主要特性
- 本地部署：运行在你的服务器或电脑上，数据完全自主可控。
- 多平台支持：支持飞书、WhatsApp、Telegram、Discord、Slack 等主流聊天工具。
- 浏览器控制：浏览网页、填写表单、提取数据。
- 系统访问：读写文件、执行 Shell 命令、运行脚本。
- 持久化记忆：记住你的偏好和上下文。
- 插件扩展：支持社区技能插件，可自定义开发。
二、部署前概念说明
- OpenClaw 本身：免费的'全能工作台'。一套开源软件，安装后永久免费使用，操作在本地电脑，数据安全有保障。
- 对接模型 API：相当于请'厨师'。需要对接大模型的 API 才能运转，这是唯一需要付费的环节，但成本极低。
推荐模型厂商
| 模型厂商 | 特点 |
|---|---|
| 智谱 GLM | 适合编程、数据分析、复杂办公 |
| 阿里通义 | 轻量体验性价比之王 |
| 字节豆包 | 兼顾性价比 + 飞书联动 |
| Kimi | 理解能力强，适合日常办公、内容创作 |
注：具体购买链接请参考各厂商官方文档。
三、安装步骤
第一步：选择模型并获取 API
参考官方部署文档，将 OpenClaw 和模型对接。
第二步：一键安装 OpenClaw
无需下载安装包，打开终端/命令提示符，复制对应系统的命令执行。
🖥️ Mac/Linux 用户
curl -fsSL https://clawd.org.cn/install.sh | bash -s -- --registry https://registry.npmmirror.com
如果手动安装依赖：
- 安装 Git
sudo yum update && sudo yum install git -y
- 安装 Node.js (通过 NVM)
curl -o- https://gitee.com/RubyMetric/nvm-cn/raw/main/install.sh | bash
export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node
curl -o- https://gitee.com/mirrors/nvm/raw/master/install.sh | bash
source ~/.bashrc
nvm install 22
node -v # 输出 v22 即可
- 使用官方脚本安装
curl -fsSL https://openclaw.bot/install.sh | bash
🖥️ Windows 用户
iwr -useb https://clawd.org.cn/install.ps1 -OutFile install.ps1; .\install.ps1 -Registry https://registry.npmmirror.com
第三步：安全确认
安装过程中会出现安全警告界面，需明确确认风险。
# 界面显示如下：
安全警告 - 请阅读。
OpenClaw 是一个业余项目，仍处于测试阶段...
我理解这很强大且本质上存在风险。继续吗？
○ Yes / ● No
操作步骤：
- 按键盘
→右键把光标从● No移到○ Yes。 - 按
回车键 Enter。
第四步：配置向导
确认安全警告后，安装程序引导配置：
| 步骤 | 操作 | 建议 |
|---|---|---|
| 配置模式 | QuickStart vs Manual | 选 QuickStart |
| 模型选择 | 提供商选择 | 选 Skip for now（稍后再配） |
| 聊天渠道 | Telegram/飞书等 | 选 Skip for now（先用 Web 界面） |
| 技能配置 | 基础功能包 | 选 Yes |
| 包管理器 | npm/pnpm | 选 npm |
| 记忆功能 | Hooks | 选中 session-memory 和 boot-md |
| 启动方式 | 如何启动助手 | 选 Do this later |
若遇到网络问题，可配置国内镜像源。如安装失败，可参考官方文档手动安装 Node.js 和 NVM。
四、模型配置
安装完成后，执行命令配置模型。
# 设置提供商（以阿里云百炼为例）
openclaw-cn config set provider dashscope
# 设置 API 密钥
openclaw-cn config set apiKey sk-你的 API 密钥
# 设置模型名称
openclaw-cn config set model qwen-max
API 密钥获取方式：
- 登录阿里云百炼控制台。
- 进入'模型广场' → 'API-KEY 管理'。
- 创建新的 API Key，复制以
sk-开头的密钥。
其他厂商（如智谱、Kimi、火山引擎）也可参照官方文档进行类似配置。
五、启动与访问
启动网关
# 启动 OpenClaw 网关
openclaw-cn gateway
# 或者后台运行
nohup openclaw-cn 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" 仅监听本地，必须使用 SSH 隧道。如需 Docker 访问，可将 bind 改为 lan，但需注意安全风险。
六、核心技能扩展
安装完成只是开始，建议安装以下核心技能以提升能力：
| 技能名称 | 作用 |
|---|---|
| self-improvement | 自我改进神器，自动记录错误、总结经验 |
| browser | 浏览器自动化核心，网页交互、截图、数据爬取 |
| desktop-control | 桌面操控大师，鼠标、键盘、软件操作自动化 |
| auto-updater | 自动更新，实时同步 Clawdbot 和技能 |
| skill-vetter | 安全防护盾，扫描技能风险 |
| subagent-driven-development | 智能管理者，委派复杂任务 |
| vector-memory | 记忆优化器，解决上下文杂乱问题 |
| clawhub | 技能应用市场，检索安装功能 |
七、学习资源
- OpenClaw 官网文档：https://docs.openclaw.ai/zh-CN
- Awesome-openclaw-skills：https://github.com/VoltAgent/awesome-openclaw-skills
- 中文社区：https://clawd.org.cn/
- 新手教程：https://awesome.tryopenclaw.asia/
八、安全提醒
OpenClaw 具备高权限，请务必做好安全防护：
- 关闭默认无密码端口：避免暴露 18789 默认端口，防止被黑客入侵。
- 谨慎授予高权限：不要让它随意操作系统文件夹，避免因模型偏差误删文件。
- 只装正规技能：通过 clawhub 或官方渠道安装，避免恶意技能。
- 当作'实习生'：复杂重要任务，一定要自己审核结果。
关于绑定地址 (bind) 的安全设计：
OpenClaw 默认配置 "bind": "loopback" 是为了安全，仅监听本机。若需外部访问（如 Docker），应使用 "lan" 而非直接写 0.0.0.0，以防止服务意外暴露到公网。近期安全更新已强制枚举允许的值，确保用户不会因配置错误导致漏洞。
修改示例：
"gateway":{"port":18789,"mode":"local","bind":"lan",...}
重启服务生效：
pkill -f openclaw
openclaw-cn gateway &
