介绍在国内网络环境下部署 OpenClaw 个人 AI 助手的完整流程。涵盖 Node.js 环境配置、OpenClaw 安装方式（npm/源码/Docker）、国内模型 API 适配（DeepSeek 等）、飞书渠道接入及内网穿透调试。重点解决 npm 镜像源、GitHub 访问及消息通道网络限制问题，提供本地运行与服务器部署方案，确保数据隐私与合规性。
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