OpenClaw 本地部署与使用指南：打造 AI 个人助理

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 即可

3. 使用官方脚本安装

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

操作步骤：

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

第四步：配置向导

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

若遇到网络问题，可配置国内镜像源。如安装失败，可参考官方文档手动安装 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 密钥获取方式：

1. 登录阿里云百炼控制台。
2. 进入'模型广场' → 'API-KEY 管理'。
3. 创建新的 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，但需注意安全风险。

六、核心技能扩展

安装完成只是开始，建议安装以下核心技能以提升能力：

七、学习资源

• 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 具备高权限，请务必做好安全防护：

1. 关闭默认无密码端口：避免暴露 18789 默认端口，防止被黑客入侵。
2. 谨慎授予高权限：不要让它随意操作系统文件夹，避免因模型偏差误删文件。
3. 只装正规技能：通过 clawhub 或官方渠道安装，避免恶意技能。
4. 当作'实习生'：复杂重要任务，一定要自己审核结果。

关于绑定地址 (bind) 的安全设计：

OpenClaw 默认配置 "bind": "loopback" 是为了安全，仅监听本机。若需外部访问（如 Docker），应使用 "lan" 而非直接写 0.0.0.0，以防止服务意外暴露到公网。近期安全更新已强制枚举允许的值，确保用户不会因配置错误导致漏洞。

修改示例：

"gateway":{"port":18789,"mode":"local","bind":"lan",...}

重启服务生效：

pkill -f openclaw
openclaw-cn gateway &