OpenClaw从零部署24小时AI管家实战指南与踩坑记录

写在前面

最近技术圈里最热的话题，莫过于那只名叫OpenClaw（前身Clawdbot/Moltbot）的“小龙虾”了。作为GitHub上增长速度惊人的开源项目之一，它和只会“动嘴皮子”的ChatGPT不同，这是一个真正能动手干活的AI Agent——浏览网页、执行命令、管理文件，甚至帮你写代码。

只能说，官方文档对国内用户确实不算友好，在实际部署中遇到的坑也不少。这篇文章记录的就是从零开始的完整部署流程，再加上整理的中文优化资料，希望能让后来者少走些弯路。

一、OpenClaw是什么？为什么值得折腾？

简单来说，OpenClaw是一个运行在你自有服务器上的高权限AI智能体。它跟那些SaaS类的AI服务有本质区别：

• 数据自主可控：所有操作都在本地或云端服务器完成，敏感信息不出境
• 7×24小时待命：部署后，通过Telegram、飞书、钉钉等渠道随时唤醒
• 真正的动手能力：不是给建议，而是直接执行命令、操作浏览器、读写文件

那些需要自动化处理重复工作的场景，比如定时拉取数据生成报表、自动回复标准化咨询、远程执行服务器维护等，这个工具尤其适合。

二、部署前的准备工作

根据官方要求和个人实践经验，下面是建议的配置参考：

一个关键提醒：国内服务器访问GitHub或npm可能不稳定，建议提前准备好袋里或直接使用镜像源。

三、实战部署：三步走策略

第一步：环境初始化（5分钟）

先安装Git和Node.js环境。这里有个避坑点：不要用apt直接装Node.js，版本很可能不兼容。

# 安装NVM（国内用户建议用Gitee镜像）curl -o- https://gitee.com/RubyMetric/nvm-cn/raw/main/install.sh | bash
source ~/.bashrc
# 安装Node.js 22nvm install 22
nvm use 22
node -v  # 确认输出v22.x.x

第二步：安装OpenClaw（3分钟）

官方有一键安装脚本，但国内网络环境下容易中断。如果遇到问题，下面的离线安装方案可以参考。

# 官方一键安装（网络通畅时）curl -fsSL https://openclaw.ai/install.sh | bash
# 或者通过npm安装（更稳定）npm install -g openclaw@latest

安装完成后，首次运行会看到一个ASCII艺术小龙虾和交互式配置向导。

░████░█░░░░░█████░█░░░█░███░░████░░████░░▀█▀
? FRESH DAILY ?

第三步：配置向导详解（10分钟）

运行openclaw onboard --install-daemon进入配置，关键步骤如下：

1. 安全确认
向导会明确提示风险：Agent可以执行命令、读写文件。输入yes继续。

2. 选择AI后端
国内用户强烈推荐选择通义千问(Qwen)或GLM：

• 前往阿里云百炼或智谱AI创建API Key
• 免费额度通常足够个人使用几个月

3. 配置消息渠道

• 新手建议选Telegram Bot（最简单，5分钟搞定）
• 国内办公场景可选飞书或钉钉，需要额外配置Webhook

4. 安装守护进程
选择--install-daemon参数会自动创建系统服务，实现开机自启。

四、进阶配置：让AI真正“可用”

基础部署完成后，还要做三个关键配置，才能让它真正投入生产。

1. 持久化记忆配置

OpenClaw通过本地Markdown文件存储偏好，编辑~/.openclaw/openclaw.json即可：

{
  "agent": {
    "memory": {
      "enabled": true,
      "storagePath": "~/.openclaw/memory"
    }
  }
}

2. 安全沙箱（强烈推荐）

默认情况下Agent权限较高，建议启用Docker沙箱隔离：

{
  "agents": {
    "defaults": {
      "sandbox": {
        "mode": "non-main",
        "docker": {
          "image": "openclaw-sandbox:bookworm-slim",
          "network": "none"
        }
      }
    }
  }
}

3. 防火墙与端口

确保服务器放行18789端口（Gateway默认端口）：

sudo ufw allow 18789/tcp
# 或云服务器安全组配置

五、国内部署的特殊技巧

因为网络环境差异，国内部署需要一些“土办法”。

镜像加速：npm和Docker拉取经常超时，建议使用淘宝NPM镜像、阿里云Docker镜像等国内源。

模型选择：实测通义千问Qwen2.5-coder在代码任务上表现不错，而且阿里云的免费额度比较慷慨。配置示例如下：

{
  "agent": {
    "model": "qwen2.5-coder:32b",
    "providers": {
      "qwen": {
        "apiKey": "sk-your-key",
        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1"
      }
    }
  }
}

移动端访问：部署完成后，通过飞书或钉钉接入，就能用手机远程操控家里或公司的电脑，这应该是目前最符合国内使用习惯的方案了。

六、常见问题与排查

七、写在最后

OpenClaw的出现，代表着AI Agent正在从“玩具”走向“工具”。部署它虽然比使用ChatGPT要复杂一些，但换来的，是完全的数据所有权和无限的定制化能力。

如果部署过程中遇到文档里没有提到的问题，欢迎交流。文中提到的配置文件模板、镜像加速地址，以及各平台Bot创建的具体截图步骤，都已经整理好，方便随时查阅。

毕竟，配置一次，受益许久。当你的AI助手开始在凌晨三点自动处理邮件时，你会感谢现在折腾的自己。

参考资源：

• OpenClaw官方文档: docs.openclaw.ai
• 阿里云部署指南: 开发者社区
• 本文配套资料: fuye365.github.io