从这里开始 / GET STARTED

让第一项工作,
先跑起来。

有终端就能开始。先在电脑上安装并打开工作区,再让手机接着跟进。

自己开始 / THREE STEPS

安装、启动,开始一项任务。

先准备 Node.js 22.x ↗。支持 Apple Silicon Mac、Linux glibc x64 / arm64、Windows x64。无需克隆源码。

01

一条命令,安装组件。

在准备运行 Agent 的电脑或服务器上打开终端。

macOS / Linux
安装命令(macOS / Linux)
npm install -g @runweave/cli@latest @runweave/server@latest

Windows PowerShell
安装命令(Windows)
npm.cmd install -g @runweave/cli@latest @runweave/server@latest

02

设置账号,启动工作区。

依次执行。初始化时设置账号并保存终端展示的密码;检查通过后再启动服务。

macOS / Linux
初始化与启动(macOS / Linux)
rw server init &&
rw server doctor --json &&
rw server start

Windows PowerShell
初始化与启动(Windows)
rw.cmd server init
if ($LASTEXITCODE -eq 0) {
  rw.cmd server doctor --json
  if ($LASTEXITCODE -eq 0) { rw.cmd server start }
}

保持启动窗口打开。在另一个终端运行 rw server status --json 查看状态(Windows 使用 rw.cmd)。已有服务正在运行时直接使用,不重复启动。

03

打开网页,运行第一个任务。

在这台电脑的浏览器打开 http://127.0.0.1:5001/ ↗,用刚设置的账号登录。选择项目目录,创建终端,启动已安装并登录的 Agent CLI。

示例:在 Runweave 终端中启动 Codex
codex

也可以启动 Claude Code、其他 CLI 或项目脚本。Runweave 不会替你安装或登录这些 Agent;缺少依赖时按 doctor 的结果处理。

交给 AI / AGENT READY

复制这段,让 AI 帮你开始。

交给能在目标电脑上执行命令的 AI Agent。它会先检查已有环境,再按需安装和验证;账号密码由你在本机输入。

给 AI 的安装与使用指令
请帮我在这台机器上安装并开始使用 Runweave。先阅读下面的 Agent 使用指南,再执行当前环境需要的步骤。先检查已有安装与运行状态,复用现有配置和数据,不覆盖、不重置。安装 CLI 和 Server 后,检查环境,协助我完成账号初始化,在本机启动并验证 Web 可用,再指导我创建第一个项目与终端。账号密码由我在本机安全输入,不写入聊天或脚本。Agent CLI 的安装和登录单独核对;手机和远程连接另行配置,完成安装不代表已远程可用。

指南地址:https://runweave.jackshen310.cn/agent-guide.txt

接着使用 / WHAT’S NEXT

手机接续,多台机器一起用。

连接手机

安装 Runweave iOS App,添加手机可访问的电脑地址,用同一账号登录,打开对应项目与终端。

上面的 127.0.0.1 只在电脑本机有效。手机需要局域网或已配置好的受控远程入口;安装完成不会自动开通外网访问。

iOS 安装与连接说明 ↗

再加一台机器

在另一台支持的电脑上重复安装、初始化和检查,再在客户端添加对应连接。每台机器沿用自己的工具和数据。

服务端安装与运行说明 ↗

遇到问题,从检查结果开始。

权限不足时使用可写的 npm 全局目录;端口已被占用时先核对现有实例;终端或 Agent 不可用时检查系统工具和登录状态。不要为了首次启动覆盖原配置或重置数据。

查看完整安装与排障说明 ↗