OpenClaw 完全指南：开源 AI 助手部署与配置

2.2 核心功能演示

# 搜索最新科技新闻
"帮我搜索今天的人工智能新闻"
# 编写代码
"用 Python 写一个斐波那契数列生成器，要求使用生成器实现"
# 操作文件
"帮我整理 Downloads 文件夹，按文件类型分类"
# 处理邮件
"帮我查看今天的邮件，并总结重要事项"
# 系统操作
"帮我查看当前系统的 CPU 和内存使用情况"

三、安装部署指南

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. 模型/认证配置

Model/auth provider ○ OpenAI ○ Anthropic ○ MiniMax ● Moonshot AI (Kimi K2 + Kimi Coding) ○ Google ○ OpenRouter ○ Qwen ○ Z.AI (GLM 4.7) ○ Copilot ○ Vercel AI Gateway ○ OpenCode Zen ○ Xiaomi ○ Symbiotic ○ Venice AI ○ Skip for now

支持的模型供应商：

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

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

4. 聊天工具配置

支持的 IM 工具：

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. 配置模型 API Key
   • 前往模型服务商控制台
   • 创建 API-Key
3. 配置应用
   • 进入服务器控制台
   • 放行 18789 端口
   • 配置模型 API Key
   • 生成访问 Token
4. 集成发布
   • 配置 IM 工具（钉钉、企业微信等）
   • 开始使用

5.3 云端部署对比

六、进阶配置

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：

七、常见问题与解决方案

7.1 安装问题

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

# 在 WSL2 中执行安装
curl -fsSL https://openclaw.ai/install.sh | bash

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

# 使用 nvm 升级
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. 及时反馈
   • 如果结果不符合预期，及时纠正
   • 使用具体的例子说明需求

分步骤任务

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

清晰的指令

❌ "帮我写代码"
✅ "用 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. 参与社区：贡献代码，分享经验