🦞 OpenClaw-CN · 离线部署教程

Windows 10/11 国内网络 · 含避坑指南 · 免费模型 · 多Agent玩法

📋 目录

1. 环境准备
2. 安装OpenClaw-CN
3. 初始化向导
4. 解决中文用户名编码
5. 免费模型配置（硅基流动）
6. 核心功能与技能
7. 多Agent协同配置
8. 手机远程访问
9. 常用命令速查
10. 常见问题与解决方案

1. 环境准备

1.1 安装Node.js和Git

# 以管理员身份打开PowerShell，执行：
iwr -useb https://npmmirror.com/mirrors/node/v24.14.0/node-v24.14.0-x64.msi -OutFile node-install.msi
Start-Process .\node-install.msi -Wait
winget install Git.Git

# 验证
node --version   # 应 v24.14.0+
git --version    # 应 2.40+
    

1.2 配置国内npm镜像（关键提速）

npm config set registry https://registry.npmmirror.com
npm config get registry   # 确认输出为 https://registry.npmmirror.com/
    

1.3 放宽PowerShell执行策略（如需）

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

2. 安装OpenClaw-CN（汉化版）

npm install -g openclaw-cn@latest
openclaw-cn --version   # 应显示 0.1.8-fix.2 或更高
    

3. 初始化配置向导

openclaw-cn onboard --install-daemon

向导选项推荐：
- 安全警告 → YES
- 配置模式 → QuickStart
- 网关端口 → 默认 18789
- 模型提供商 → 先随意选（如openai），后面会替换
- API Key → 输入占位符（如 sk-placeholder）
- 默认模型 → 随意（如 gpt-3.5）
- 通讯频道 → 暂时跳过
- 技能 → YES，包管理器选 npm
- 钩子 → 暂时跳过

4. 解决中文用户名导致的编码问题

如果你Windows用户名是中文（如“张硕”），直接后台运行会遇到路径乱码。 解决方案：使用PowerShell脚本+环境变量强制指定英文配置目录。

4.1 创建D盘工作目录

mkdir D:\openclaw-cn -Force

4.2 移动配置文件并设置环境变量

# 复制现有配置（如果C盘已有）
Copy-Item C:\Users\你的用户名\.openclaw\* D:\openclaw-cn\ -Recurse

# 创建PowerShell启动脚本 D:\openclaw-cn\Start-OpenClaw.ps1
@"
`$env:OPENCLAW_CONFIG_DIR = "D:\openclaw-cn"
Set-Location D:\openclaw-cn
openclaw-cn gateway run
"@ | Out-File -FilePath D:\openclaw-cn\Start-OpenClaw.ps1 -Encoding utf8
    

4.3 创建无窗口VBS启动器

@"
CreateObject("Wscript.Shell").Run "powershell -WindowStyle Hidden -ExecutionPolicy Bypass -File D:\openclaw-cn\Start-OpenClaw.ps1", 0, False
"@ | Out-File -FilePath D:\openclaw-cn\start_gateway.vbs -Encoding ascii
    

✅ 以后双击 D:\openclaw-cn\start_gateway.vbs 即可后台运行网关，无窗口。浏览器访问 http://127.0.0.1:18789/?token=你的token 使用。

5. 免费模型配置（硅基流动）

5.1 注册并获取API密钥

访问硅基流动官网注册（手机号即可）
登录后进入「API密钥」→「创建API密钥」，复制 sk- 开头的密钥

5.2 推荐免费模型（带免费额度）

模型ID	厂商	免费额度
`Qwen/Qwen2.5-7B-Instruct`	阿里	100万 tokens/月
`deepseek-ai/DeepSeek-V3`	深度求索	1000万 tokens
`THUDM/glm-4-9b-chat`	智谱	有免费额度

⚠️ 带 Pro/ 前缀的为收费模型，务必避开。

5.3 配置命令（变量法避免参数错误）

# 设置基础信息
openclaw-cn config set models.providers.siliconflow.baseUrl "https://api.siliconflow.cn/v1"
openclaw-cn config set models.providers.siliconflow.apiKey "sk-你的真实密钥"
openclaw-cn config set models.providers.siliconflow.auth "api-key"
openclaw-cn config set models.providers.siliconflow.api "openai-completions"

# 添加免费模型（使用变量）
$modelsJson = '[{"id": "Qwen/Qwen2.5-7B-Instruct", "name": "Qwen2.5 7B", "reasoning": false, "input": ["text"], "cost": {"input":0, "output":0}, "contextWindow": 32768, "maxTokens": 8192}]'
openclaw-cn config set models.providers.siliconflow.models $modelsJson

# 设置默认主模型
openclaw-cn config set agents.defaults.model.primary "siliconflow/Qwen/Qwen2.5-7B-Instruct"

# 设置网关模式
openclaw-cn config set gateway.mode local

# 重启网关
.\D:\openclaw-cn\Start-OpenClaw.ps1   # 或双击VBS
    

6. 核心功能与技能

OpenClaw 不只是聊天，它可以通过“技能”操作电脑、联网、处理文件。

6.1 必装核心技能

技能名称	作用	安装命令
`find-skills`	技能商店（AI推荐技能）	`openclaw-cn skills install find-skills`
`tavily-search`	联网搜索（需注册Tavily）	`openclaw-cn skills install tavily-search`
`summarize`	总结长文本/邮件	`openclaw-cn skills install summarize`
`file-manager`	文件管理（读写、整理）	`openclaw-cn skills install file-manager`
`scheduler`	定时任务调度	`openclaw-cn skills install scheduler`
`email`	邮件处理	`openclaw-cn skills install email`

6.2 常用玩法示例

联网查资料：在对话中输入 /search 今天北京的天气
自动整理文件夹：帮我整理D盘下载文件夹，图片放到图片目录
总结会议纪要：上传会议录音或粘贴邮件内容，让AI总结
定时提醒：每天上午9点提醒我打卡（需安装scheduler）

7. 多Agent协同配置（进阶）

7.1 创建不同角色的Agent

openclaw-cn agents add writer --workspace D:\openclaw-cn\workspace-writer
openclaw-cn agents add coder --workspace D:\openclaw-cn\workspace-coder
openclaw-cn agents list
    

7.2 定制人格（SOUL.md）

# 文案Agent
echo "你是一位资深科技文案，擅长将复杂概念通俗化，风格简洁专业。" > D:\openclaw-cn\workspace-writer\SOUL.md

# 代码Agent
echo "你是一位Python专家，只回答代码相关问题，提供可运行示例。" > D:\openclaw-cn\workspace-coder\SOUL.md
    

7.3 配置Agent团队（Orchestrator模式）

编辑 D:\openclaw-cn\openclaw.json，在 agents 中添加：

"teams": {
  "dev-team": {
    "coordinator": "main",
    "members": ["writer", "coder"]
  }
}
    

保存后重启网关，main Agent 即可调用 writer 和 coder 协作。

8. 手机远程访问

8.1 局域网访问（推荐，无需公网）

使用 ClawApp（Docker）将网关暴露到局域网。

# 安装 Docker Desktop（官网下载，配置国内镜像加速）
# 进入工作目录
cd D:\openclaw-cn
git clone https://github.com/qingchencloud/clawapp.git
cd clawapp

# 创建 .env 文件
echo 'PROXY_TOKEN=你的连接密码' > .env
echo 'OPENCLAW_GATEWAY_TOKEN=你的网关token' >> .env

# 启动服务
docker compose up -d --build
    

手机连接同一Wi-Fi，浏览器访问 http://电脑IP:3210（电脑IP可用 ipconfig 查看），输入连接密码即可。

8.2 公网访问（SSH隧道）

需一台有公网IP的服务器，配置复杂，暂不展开。可参考网上SSH反向隧道教程。

9. 常用命令速查

命令	说明
`openclaw-cn gateway start`	前台启动网关（调试用）
`openclaw-cn gateway stop`	停止网关
`openclaw-cn gateway restart`	重启网关
`openclaw-cn gateway status`	查看状态
`openclaw-cn logs --follow`	实时日志
`openclaw-cn config get <key>`	查看配置项
`openclaw-cn config set <key> <value>`	设置配置项
`openclaw-cn models list`	列出可用模型
`openclaw-cn skills list`	列出已装技能
`openclaw-cn skills install <name>`	安装技能
`openclaw-cn agents list`	列出所有Agent
`openclaw-cn doctor --fix`	自动诊断修复

10. 常见问题与解决方案

Q: openclaw-cn 命令找不到
A: npm全局路径未加入PATH。执行 npm config get prefix，将输出的路径（如 C:\Users\用户名\AppData\Roaming\npm）添加到系统环境变量PATH。

Q: 网关启动报 1006 abnormal closure
A: 中文用户名路径乱码。使用第4节的PowerShell脚本方案，并确保 $env:OPENCLAW_CONFIG_DIR 指向英文目录。

Q: 模型返回403
A: 1)API密钥无效或余额不足；2)误用了带 Pro/ 的收费模型。登录硅基流动控制台检查余额，重新生成密钥，确认模型ID正确。

Q: 飞书机器人无回复
A: 检查飞书开发者后台的App Secret是否一致，事件订阅方式是否为“长连接”，并已发布版本。查看 openclaw-cn logs --follow 获取具体错误。

Q: 端口18789被占用
A: netstat -ano | findstr :18789 找到PID，taskkill /PID 该PID /F 结束进程。