OpenClaw 开源 AI 助手部署与使用完全指南

三、安装部署指南

3.1 系统要求

💡 Windows 用户注意：强烈推荐使用 WSL2（Ubuntu），原生 Windows 未经充分测试，工具兼容性较差。

3.2 安装方式一：一键脚本（推荐）

macOS / Linux

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

Windows（PowerShell）

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

Windows（CMD）

curl -fsSL https://openclaw.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

一键脚本会自动检测环境、安装 Node.js（≥22）、安装 OpenClaw 并启动 onboarding 配置向导。

3.3 安装方式二：手动安装

# 使用 npm
npm i -g openclaw

# 或使用 pnpm
pnpm add -g openclaw

# 初始化并安装后台服务
openclaw onboard

3.4 安装方式三：从源码安装（开发模式）

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build # 构建前端界面
pnpm build # 构建整个项目

# 初始化并安装为系统后台服务
pnpm openclaw onboard --install-daemon

# 开发模式：监听代码变更
pnpm gateway:watch

四、配置与初始化

4.1 运行配置向导

安装完成后，运行 onboarding 向导：

openclaw onboard --install-daemon

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

1. 安全确认

Must read: https://docs.openclaw.ai/gateway/security
I understand this is powerful and inherently risky. Continue?
◎ Yes / ● No

选择 Yes 继续。OpenClaw 能直接执行系统命令和操作文件，确实存在风险，建议先阅读安全文档了解详情。

2. 启动模式选择

Onboarding mode
● QuickStart (configure details later via openclaw configure.)
○ Manual

选择 QuickStart 模式（快速启动，后续可通过 openclaw configure 修改配置）。

3. 模型/认证配置

支持的模型供应商包括 OpenAI、Anthropic、Moonshot AI（Kimi K2 + Kimi Coding）、Qwen（通义千问）、Z.AI（GLM 4.7）、MiniMax、Google 等。

国内用户推荐：Moonshot AI（Kimi）或 Qwen（通义千问），无需海外账号，响应速度快。

选择供应商后，需要配置 API Key 或 OAuth 认证。

4. 聊天工具配置

支持的 IM 工具包括 WhatsApp（二维码扫描登录）、Telegram（Bot Token）、微信（插件/第三方服务）、钉钉/飞书/企业微信（机器人 Token）、QQ（插件）。

5. 端口配置

默认网关端口：18789 访问地址：http://127.0.0.1:18789/chat

6. Skills 选择

可以选择预置的技能包：Web 搜索、代码编辑、文件操作、系统命令、邮件处理。也可以直接跳过，后续再安装。

4.2 常用命令

# 查看状态
openclaw status

# 查看详细状态
openclaw status --all

# 健康检查
openclaw health

# 启动网关
openclaw gateway start

# 停止网关
openclaw gateway stop

# 重启网关
openclaw gateway restart

# 查看网关状态
openclaw gateway status

# 发送测试消息
openclaw message send --target +15555550123 --message "Hello from OpenClaw"

4.3 配对与安全

默认策略：未知私信会收到一个配对码，需要批准后才能交互。

# 查看待批准的配对请求
openclaw pairing list whatsapp

# 批准配对
openclaw pairing approve whatsapp <code>

五、云端一键部署方案

5.1 为什么选择云端部署？

5.2 云服务器部署通用步骤

以主流云厂商为例，通常包含以下步骤：

1. 购买实例：选择轻量应用服务器或 ECS，推荐配置 2vCPU + 2GiB 内存。
2. 配置镜像：部分云厂商提供 OpenClaw 应用镜像，可直接选择。
3. 配置模型 API Key：前往 Moonshot AI 或阿里云百炼控制台创建 API-Key。
4. 配置应用：进入服务器控制台，放行 18789 端口，配置模型 API Key。
5. 集成发布：配置 IM 工具（钉钉、企业微信等），开始使用。

注：具体价格与优惠活动请参考各云厂商官方页面，此处仅展示技术流程。

六、进阶配置

6.1 配置文件详解

配置文件位置：~/.openclaw/config.json

{
  "routing": {
    "agents": {
      "main": {
        "workspace": "~/clawd",
        "sandbox": { "mode": "off" }
      }
    }
  },
  "gateway": {
    "port": 18789,
    "auth": { "token": "your-gateway-token" }
  },
  "models": {
    "default": "claude-3-5-sonnet",
    "providers": {
      "anthropic": { "apiKey": "your-anthropic-api-key" },
      "aliyun": { "apiKey": "your-aliyun-api-key" }
    }
  }
}

6.2 沙盒模式配置

沙盒模式用于隔离群组/频道会话，保护主环境：

{
  "routing": {
    "agents": {
      "defaults": {
        "sandbox": { "mode": "non-main" }
      }
    }
  }
}

• mode: "off" - 关闭沙盒，在主环境运行
• mode: "non-main" - 非主代理使用沙盒

6.3 安装 Skills

OpenClaw 支持通过 Skills 扩展功能：

# 查看可用 Skills
openclaw skills list

# 安装 Skill
openclaw skills install web-search
openclaw skills install code-editor
openclaw skills install file-operations

# 查看已安装 Skills
openclaw skills installed

推荐 Skills：web-search（网络搜索）、code-editor（代码编辑）、file-operations（文件操作）、system-commands（系统命令）、email-handler（邮件处理）。

七、常见问题与解决方案

7.1 安装问题

Q: Windows 安装失败怎么办？ A: 强烈推荐使用 WSL2（Ubuntu）：

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

Q: Node.js 版本不够怎么办？ A: 升级 Node.js 到 22 或以上：

nvm install 22
nvm use 22

7.2 配置问题

Q: 显示 "no auth configured" 怎么办？ A: 返回向导设置 OAuth 或 API Key：

openclaw onboard

Q: WhatsApp / Telegram 连接失败？ A:

1. 确保使用 Node 运行网关（不是 Bun）
2. 检查网络连接
3. 重新扫描二维码或配置 Bot Token

Q: 首次私信没有回复？ A: 需要批准配对：

openclaw pairing list <channel>
openclaw pairing approve <channel> <code>

7.3 性能优化

Q: 如何降低延迟？ A:

1. 选择就近的云服务器区域
2. 使用国内模型（阿里云百炼、MiniMax）
3. 开启缓存和会话保持

Q: 如何提高稳定性？ A:

1. 使用云端部署代替本地部署
2. 配置 systemd/launchd 守护进程
3. 开启自动重启

八、最佳实践

8.1 安全建议

1. API Key 管理：不要将 API Key 硬编码在代码中，使用环境变量或配置文件，定期轮换 API Key。
2. 访问控制：启用配对验证，限制可访问的 IM 账号，配置防火墙规则。
3. 数据隔离：使用沙盒模式运行非信任会话，定期清理敏感数据，备份重要配置。

8.2 使用技巧

1. 及时反馈：如果结果不符合预期，及时纠正，使用具体的例子说明需求。
2. 分步骤任务：

   ❌ "帮我做一个网站"
   ✅ "第一步：创建一个 Flask 项目结构；第二步：写一个首页路由..."
   

3. 清晰的指令：

   ❌ "帮我写代码"
   ✅ "用 Python 写一个函数，输入一个列表，返回去重后的有序列表"
   

8.3 团队协作

1. 共享配置：使用版本控制管理配置文件，文档化团队规范。
2. 权限管理：区分开发、测试、生产环境，配置不同的模型和工具权限。
3. 监控告警：配置日志收集，设置异常告警，定期检查健康状态。

九、生态与社区

9.1 官方资源

• 官网：https://openclaw.ai/
• GitHub：https://github.com/openclaw/openclaw
• 中文文档：https://clawd.org.cn/

9.2 Skills 生态

• Awesome OpenClaw Skills：https://github.com/VoltAgent/awesome-openclaw-skills
• 社区贡献的各种 Skills 扩展

9.3 社区交流

• GitHub Issues：问题反馈和功能建议
• Discord/Telegram 群组：技术交流
• 各大云平台交流群：部署经验分享

十、总结

OpenClaw 的核心价值

1. 真正可执行的 AI：不只是聊天，而是完成实际任务
2. 本地优先：数据安全，隐私可控
3. 开源免费：社区驱动，持续迭代
4. 多渠道接入：支持主流 IM 工具
5. 云端部署：7×24 小时在线服务

适用人群

• 👨‍💻 开发者：代码助手、自动化脚本
• 💼 职场人士：邮件处理、日程管理、周报生成
• 🎓 学生：学习助手、资料整理
• 🏢 企业团队：内部工具、自动化流程

下一步行动

1. 快速体验：使用一键脚本在本地安装
2. 稳定使用：在阿里云/腾讯云/天翼云部署云端版本
3. 深度定制：开发自己的 Skills，扩展功能
4. 参与社区：贡献代码，分享经验

本文基于 OpenClaw 最新版本编写，项目正在快速迭代中，建议关注官方更新。