在国内环境部署 OpenClaw:从零到跑通的个人 AI 助手搭建指南
OpenClaw 是一个开源的个人 AI 助手框架,可以连接 WhatsApp、Telegram、Slack、Discord、飞书等 20+ 消息渠道。本文记录了在国内网络环境下部署 OpenClaw 的完整流程,包括网络适配、模型配置、渠道接入等实战经验。
在国内网络环境下部署 OpenClaw 个人 AI 助手的完整流程。涵盖环境准备(Node.js)、安装方式(npm/源码/Docker)、初始配置、国内网络适配(npm/GitHub/API 镜像)、消息渠道接入(重点飞书)及常见问题解决。推荐使用国内模型 API(如 DeepSeek)和飞书渠道,配合内网穿透工具实现本地开发调试,支持 Docker 部署于云服务器,确保数据本地化与合规运行。
OpenClaw 是一个开源的个人 AI 助手框架,可以连接 WhatsApp、Telegram、Slack、Discord、飞书等 20+ 消息渠道。本文记录了在国内网络环境下部署 OpenClaw 的完整流程,包括网络适配、模型配置、渠道接入等实战经验。
OpenClaw 是一个 local-first 的个人 AI 助手平台。它的核心是一个 Gateway 服务,运行在你自己的设备上,通过 WebSocket 管理会话、消息路由和工具调用。
核心特性:
| 项目 | 要求 |
|---|---|
| 操作系统 | macOS / Linux / Windows(WSL2) |
| Node.js | ≥ 22 |
| 磁盘空间 | ≥ 2GB |
| 网络 | 需要访问 npm registry 和 GitHub |
推荐使用 nvm 或 fnm 管理 Node.js 版本:
# 使用 fnm
curl -fsSL https://fnm.vercel.app/install | bash
source ~/.zshrc
fnm install 22
fnm use 22
# 验证
node --version
# 应显示 v22.x.x
国内加速:如果 Node.js 下载慢,可以设置镜像。
npm install -g openclaw@latest
国内加速:设置 npm 镜像源。
curl -fsSL https://openclaw.ai/install.sh | bash
如果
openclaw.ai无法访问,可以用 npm 方式安装。
git clone https://ghproxy.cn/https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build
pnpm openclaw onboard --install-daemon
如果你使用 macOS,可以直接下载 AutoClaw 应用,这是 OpenClaw 的桌面客户端封装,开箱即用。
openclaw onboard --install-daemon
向导会引导你完成:
# 检查状态
openclaw gateway status
# 前台运行(调试用)
openclaw gateway --port 18789 --verbose
# 打开控制台
openclaw dashboard
访问 http://127.0.0.1:18789/ 即可打开 Web 控制台。
这是国内部署最关键的部分。OpenClaw 本身不需要科学上网,但部分依赖需要处理。
# 临时使用镜像
npm install -g openclaw@latest --registry=https://registry.npmmirror.com
如果需要从源码构建或更新:
# 方案 1:使用代理
git config --global http.proxy http://127.0.0.1:7890
# 方案 2:使用 GitHub 镜像
# ghproxy.cn 或 gitclone.com
git clone https://ghproxy.cn/https://github.com/openclaw/openclaw.git
OpenClaw 支持多种模型提供商。在国内环境下,推荐以下方案:
OpenClaw 支持 OpenAI 兼容的 API 格式,大部分国内厂商都支持:
models:
default: deepseek
providers:
deepseek:
type: openai-compatible
baseURL: https://api.deepseek.com/v1
apiKey: sk-your-deepseek-key
model: deepseek-chat
支持的国内模型提供商:
如果你有 OpenAI API Key:
models:
default: openai
providers:
openai:
type: openai
apiKey: sk-your-openai-key
# 通过代理访问
baseURL: https://your-proxy.example.com/v1
微软 Azure 在国内有合规节点:
models:
default: azure
providers:
azure:
type: azure-openai
endpoint: https://your-resource.openai.azure.com/
apiKey: your-azure-key
deployment: gpt-4o
不同消息渠道在国内的可达性不同:
| 渠道 | 国内可用性 | 备注 |
|---|---|---|
| 飞书 | ✅ 原生支持 | 国内首选,延迟低 |
| Telegram | ⚠️ 需代理 | 需要科学上网 |
| Discord | ⚠️ 需代理 | 需要科学上网 |
| Slack | ⚠️ 需代理 | 需要科学上网 |
| WebChat | ✅ 本地访问 | 无网络限制 |
| 微信 | ⚠️ 非官方 | 通过第三方桥接 |
| 钉钉 | ⚠️ 需适配 | 可通过 webhook |
国内推荐组合:飞书 + WebChat
飞书是国内使用 OpenClaw 的最佳消息渠道。
App ID 和 App Secrethttps://your-server/feishu/webhook在 OpenClaw 配置文件中添加飞书渠道:
channels:
feishu:
appId: your-app-id
appSecret: your-app-secret
verificationToken: your-verification-token
encryptKey: your-encrypt-key # 可选
使用内网穿透工具暴露本地端口:
# 方案 1:ngrok(海外)
ngrok http 18789
# 方案 2:cpolar(国内友好)
cpolar http 18789
# 方案 3:frp(自建)
# 配置 frp 客户端将本地 18789 端口暴露到公网
将生成的公网 URL 填入飞书事件订阅的请求地址。
如果你想在云服务器上部署 OpenClaw:
git clone https://github.com/openclaw/openclaw.git
cd openclaw
./docker-setup.sh
# docker-compose.yml
version: '3.8'
services:
openclaw:
image: ghcr.io/openclaw/openclaw:latest
ports:
- "18789:18789"
environment:
- OPENCLAW_HOME=/home/node
volumes:
- openclaw-data:/home/node
restart: unless-stopped
volumes:
openclaw-data:
# 配置 Docker 镜像加速
sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<EOF
{
"registry-mirrors": [
"https://docker.1ms.run",
"https://docker.xuanyuan.me"
]
}
EOF
sudo systemctl restart docker
# 服务管理
openclaw gateway status # 查看状态
openclaw gateway start # 启动
openclaw gateway stop # 停止
openclaw gateway restart # 重启
# 调试
openclaw doctor # 诊断问题
openclaw dashboard # 打开控制台
# 消息
openclaw message send --to user --message "你好"
# 更新
openclaw update # 更新到最新版
# 技能管理
openclaw skill list # 列出已安装技能
openclaw skill install xxx # 安装技能
# 使用镜像源
npm install -g openclaw@latest --registry=https://registry.npmmirror.com
# 或设置全局镜像
npm config set registry https://registry.npmmirror.com
# 检查端口占用
lsof -i :18789
# 查看日志
openclaw gateway --verbose
# 运行诊断
openclaw doctor
curl -v https://api.deepseek.com/v1/models# 命令行临时切换
openclaw agent --message "测试" --model deepseek-chat
# 持久化修改
# 在配置文件中修改 default model
OpenClaw 的 Skill 系统允许你扩展助手能力:
# 浏览可用技能
openclaw skill list
# 安装技能
openclaw skill install feishu-doc
openclaw skill install autoglm-websearch
访问 ClawHub 发现更多技能。
# 创建定时任务(比如每天早上 9 点发送天气)
openclaw cron create --schedule "0 9 * * *" --message "今天天气怎么样?"
可以为不同的渠道配置不同的 Agent:
channels:
feishu:
agentId: work-agent
telegram:
agentId: personal-agent
在国内环境部署 OpenClaw 的关键要点:
OpenClaw 的 local-first 设计理念让数据完全留在本地,这对注重隐私的用户来说是一个很大的优势。搭配国内模型服务,整个方案可以在完全合规的环境下运行。
参考资料:
本文基于 OpenClaw 最新版本编写,具体配置可能随版本更新而变化。建议部署前查阅官方文档获取最新信息。

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online
JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online
Terser 压缩、变量名混淆,或 javascript-obfuscator 高强度混淆(体积会增大)。 在线工具,JavaScript 压缩与混淆在线工具,online