OpenClaw 完整安装与配置

新手启程，记录下deepin20.9系统下“装虾”的过程。本文将分步记录 OpenClaw 的安装、国内镜像源配置、网关设置、技能安装及常见问题排查，仅适合本人自我学习。😏

一、前期准备：配置 npm 国内镜像源

为加速 Node.js 相关包的安装，先将 npm 镜像源切换到国内源：

bash运行

npm config set registry https://registry.npmmirror.com

二、一键安装 OpenClaw 及依赖

执行以下命令自动安装 Node.js、Git 和 OpenClaw（支持 Linux 系统）：

bash运行

sudo curl -fsSL https://openclaw.ai/install.sh | bash

安装过程说明

安装脚本会自动完成以下操作：

1. 检测系统环境（Linux），确认 Node.js/Git 是否已安装
2. 升级现有 OpenClaw 到最新版本（示例中为 2026.3.2），截止发文目前已更新至2026.3.13
3. 运行 openclaw doctor 进行环境检查和初始化配置
4. 自动提示并完成以下关键配置（建议全部选择 Yes）：
   • 生成并配置网关 Token
   • 收紧～/.openclaw 目录权限为 700（安全要求）
   • 创建会话存储目录～/.openclaw/agents/main/sessions
   • 安装 bash 命令补全
   • 安装 Gateway 系统服务（推荐 Node 运行时）

三、安装 Clawhub 技能

1. 安装 Clawhub（与 OpenClaw 环境保持一致）

bash运行

sudo env SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g clawhub@latest

2. 安装 Sonoscli 技能示例

bash运行

npx clawhub@latest install sonoscli

四、网关配置（解决本地访问问题）

1. 基础网关设置

bash运行

# 设置网关模式为本地
openclaw config set gateway.mode local

# 重启网关服务使配置生效
openclaw gateway start

# 验证网关模式是否设置成功（应返回 local）
openclaw config get gateway.mode

2. 配置网关认证 Token

bash运行

# 设置网关 Token（替换为实际 Token）
openclaw config set gateway.auth.token "这里为你的token"

# 设置认证模式为 Token
openclaw config set gateway.auth.mode token

# 验证配置是否生效
openclaw config get gateway.auth.token  # 应返回设置的 Token
openclaw config get gateway.auth.mode   # 应返回 token

3. 启动网关服务

方式 1：前台启动（测试用）

bash运行

# 前台启动网关，指定端口 18789
openclaw gateway run --port 18789

# 带强制参数和认证的启动方式（推荐）
openclaw gateway run --port 18789 --force --auth token --token $(openclaw config get gateway.auth.token)

方式 2：通过系统服务启动（后台运行）

bash运行

# 重启网关守护进程
openclaw daemon restart

4. 访问控制台

在浏览器中输入以下地址（替换「你的令牌」为实际 Token）：

plaintext

http://127.0.0.1:18789/#token=你的令牌

5. 读取明文 Token（备用）

bash运行

echo "网关有效令牌：$(jq -r '.gateway.auth.token' ~/.openclaw/openclaw.json)"

6. 恢复备份配置

将备份的 openclaw.json 复制到指定目录并重启网关：

bash运行

# 替换配置文件（假设备份文件在当前目录）
cp openclaw.json /home/xstar/.openclaw/

# 重启网关使配置生效
openclaw gateway run --port 18789 --force

五、常见问题排查

问题 1：浏览器提示「无法打开网页」

排查步骤：

1. 确认网关模式已设为 local：openclaw config get gateway.mode
2. 确认网关服务已启动：openclaw gateway start
3. 确认访问地址包含正确 Token：http://127.0.0.1:18789/#token=你的令牌

问题 2：聊天框出现「403 NoBody」错误

排查步骤：

1. 测试 SiliconFlow API 可用性（替换「你的硅基流动模型 token」）：
   bash

   运行

   curl -X POST https://api.siliconflow.cn/v1/chat/completions \
     -H "Authorization: Bearer 你的硅基流动模型token" \
     -H "Content-Type: application/json" \
     -d '{"model":"deepseek-ai/DeepSeek-V3","messages":[{"role":"user","content":"hi"}]}'
   

2. 根据返回结果定位问题：

   • 返回 {"code":30001,"message":"Sorry, your account balance is insufficient"}：SiliconFlow 账户余额不足
   • 返回 403：SiliconFlow Token 无效 / 过期
   • 返回 200：问题出在 OpenClaw 配置或请求格式

五、关键文件路径（仅是本人电脑上的文件路径）

• OpenClaw 配置目录：/home/xstar/.openclaw/
• 主配置文件：/home/xstar/.openclaw/openclaw.json
• 网关系统服务文件：/home/xstar/.config/systemd/user/openclaw-gateway.service
• 会话存储目录：~/.openclaw/agents/main/sessions

总结

1. 核心流程：配置国内镜像 → 安装 OpenClaw → 配置网关（本地模式 + Token）→ 启动服务 → 访问控制台。
2. 403 错误优先排查 SiliconFlow Token 有效性和账户余额，其次检查 OpenClaw 网关配置。
3. 关键配置文件路径为 /home/xstar/.openclaw/openclaw.json，修改后需重启网关生效。