ZeroClaw 实践指南

本文的安装过程基于模力方舟提供的国产算力容器环境对ZeroClaw进行快速安装。

1. 算力与镜像准备

当前燧原 S60 与沐曦曦云 C500 提供内置 ZeroClaw 镜像。

操作步骤：

进入模力方舟算力市场，选择对应算力配置。
选择 ZeroClaw 镜像并创建实例。
在实例中设置 SSH 登录密码（后续建立隧道时需要）。

算力选择

2. 配置模力方舟 api key

进入工作台->设置->访问令牌获取访问令牌，点击复制访问令牌。

APIKEY

进入容器终端

Jupyter

Termial

编辑~/.zeroclaw/config.toml，在第二行添加 api_key 配置，填写复制的访问令牌。

root@e83da05bb8a7:/data# cat ~/.zeroclaw/config.toml 
default_provider = "custom:https://api.moark.com/v1"
api_key="<your token>"
default_model = "Qwen3.5-27B"
default_temperature = 0.7
model_routes = []
embedding_routes = []

3. 启动 ZeroClaw

在终端中执行 "zeroclaw gateway" 启动网关，启动后会输出类似下面的日志，注意 " PAIRING REQUIRED — use this one-time code" 这一行下面的 6 位配对码是用于网关 Dashboard 认证的配对码：

root@e83da05bb8a7:/data# zeroclaw gateway
2026-03-04T08:52:54.852506Z  INFO zeroclaw::config::schema: Config loaded path=/root/.zeroclaw/config.toml workspace=/root/.zeroclaw/workspace source="default" initialized=false
2026-03-04T08:52:54.852580Z  INFO zeroclaw: 🚀 Starting ZeroClaw Gateway on 127.0.0.1:42617
🦀 ZeroClaw Gateway listening on http://127.0.0.1:42617
  🌐 Web Dashboard: http://127.0.0.1:42617/
  POST /pair      — pair a new client (X-Pairing-Code header)
  POST /webhook   — {"message": "your prompt"}
  GET  /api/*     — REST API (bearer token required)
  GET  /ws/chat   — WebSocket agent chat
  GET  /health    — health check
  GET  /metrics   — Prometheus metrics

  🔐 PAIRING REQUIRED — use this one-time code:
     ┌──────────────┐
     │  321734  │
     └──────────────┘
     Send: POST /pair with header X-Pairing-Code: 321734
  Press Ctrl+C to stop.

此时可通过以下命令与 ZeroClaw 进行简单对话测试，如果没有问题会看到 Agent 的回应：

$ zeroclaw agent -m "Hello, ZeroClaw!"
2026-03-04T08:58:26.764711Z  INFO zeroclaw::config::schema: Config loaded path=/root/.zeroclaw/config.toml workspace=/root/.zeroclaw/workspace source="default" initialized=false
2026-03-04T08:58:26.765935Z  INFO zeroclaw::agent::loop_: Memory initialized backend="sqlite"
Hey there! 🦀 I'm ZeroClaw — your Rust-forged personal assistant.

I just woke up and read through my identity files. Looks like we're just getting started! I'm here to help you get things done, whether that's coding, organizing, searching for info, or whatever else you need.

What's on your mind today?

如果需要配置第三方 IM，请参考：https://github.com/zeroclaw-labs/zeroclaw/blob/main/docs/channels-reference.md

因本地机器无法直接访问云端算力内网，需通过隧道代理完成网络穿透。

首先返回算力容器页面，获取对应算力的用户名、地址和端口号。

算力��信息

随后打开本地机器的终端（注意是本地机器而非云端算力的终端）输入隧道代理的指令：

ssh -CNg -L 18789:127.0.0.1:42617 云端算力的用户名@云端算力的地址 -p ssh的端口

// 示例如下：
// ssh -CNg -L 42617:127.0.0.1:42617 root+vm-F6W5bm****AjJMTGl@106.***.***.118 -p 32222