管理 AI 代理通常意味着在终端窗口、SSH 会话和散落各处的配置文件之间疲于奔命。Office Claws 用一个 CLI 取代了这一切——另外还有一个桌面应用,里面是一间像素艺术办公室,每个代理都坐在自己的工位上。每个代理都运行在您自己 Contabo 账户中的一台 VPS 上,并通过您自己的 Tailscale 网络与您的电脑通信。本指南将带您完成设置的每一步,从安装 CLI 到与您的第一个代理对话。
开始之前的准备工作
开始前请先准备好以下内容。一切就绪的话,整个设置只需几分钟。
账户和凭据
- Office Claws 订阅。 只有一个套餐:Self-Hosted,每月 $4.99。部署代理前必须拥有有效订阅——您可以在第 2 步直接通过 CLI 订阅。
- 带有 VPS 的 Contabo 账户。 您的代理运行在您自己 Contabo 账户中的 VPS 上,服务器费用直接付给 Contabo——一台小型 VPS 每月只需几欧元。请在开始引导流程前先在 Contabo 订购 VPS。Office Claws 每台 VPS 运行一个代理。
- Contabo API 凭据。 打开 my.contabo.com/api/details,记下您的 Client ID 和 Client secret(在 "API Data" 下)、API user(您登录 Contabo 的邮箱)以及 API password。API 密码不是您的网站登录密码——如果您从未设置过,请在该页面点击 "Set password"。
- Tailscale 账户和授权密钥。 Tailscale 在您的电脑和代理的 VPS 之间建立加密网络。在 tailscale.com 创建一个免费账户,然后在管理控制台的 Settings > Keys > Generate auth key 中生成授权密钥。
- 带 Codex 的 ChatGPT 订阅。 您的代理使用您自己的 OpenAI Codex(ChatGPT)订阅运行,在第 5 步通过浏览器登录即可连接。无需 API 密钥。
- 一台运行 macOS 或 Linux、已安装并连接 Tailscale 的电脑。 CLI 通过您的 tailnet 访问代理。
价格说明
Office Claws 只有一个套餐:Self-Hosted,每月 $4.99。它包含 CLI、带像素艺术办公室的桌面应用、与代理的实时对话、日志、定时任务以及 Telegram 等渠道。基础设施始终属于您:VPS 位于您的 Contabo 账户中,由 Contabo 计费;模型则使用您自己的 Codex 订阅运行。
没有免费试用——部署前需要有效订阅。退款事宜请参阅我们的退款政策。
第 1 步:安装 CLI
用一条命令安装 officeclaws CLI:
curl -fsSL https://officeclaws.com/downloads/install.sh | sh运行 officeclaws version 确认它已在您的 PATH 中。更喜欢图形界面?带像素艺术办公室的桌面应用可在首页下载,使用的是同一个账户和同一批代理。
第 2 步:创建账户并订阅
officeclaws register # 或:officeclaws login
officeclaws subscriberegister 用邮箱和密码创建 Office Claws 账户;已有账户则使用 login。subscribe 会在浏览器中打开结账页面(如果无法打开浏览器,会打印出链接供您复制)。付款完成后,您的账户即可部署代理。
第 3 步:引导您的第一个代理
officeclaws onboard --name Mona引导流程是交互式的,它会:
- 检查您的订阅是否有效。如果无效,会提示您运行
officeclaws subscribe。 - 询问四项 Contabo API 凭据并进行验证。凭据保存在操作系统的钥匙串中,只需输入一次。
- 询问 Tailscale 授权密钥,同样保存在钥匙串中。
- 创建一个 SSH 密钥,供 CLI 访问您的代理。
- 同步您 Contabo 账户中的 VPS 列表,让您选择要变成代理的那一台。
如果省略 --name,引导流程会提示您输入名称。两个可选参数可以个性化代理:--comm-style friendly|business|creative 设置沟通语气,--avatar 从 12 个像素艺术头像中选一个,显示在桌面应用的办公室里。每个提示也都有对应参数(--contabo-client-id、--tailscale-authkey、--vps 等),因此引导流程可以完全非交互式运行——officeclaws help 会列出全部参数。
第 4 步:查看部署过程
选好 VPS 后,Office Claws 开始部署,并把进度直接输出到终端:
- 从预构建的 Office Claws 镜像安装代理。
- 将 VPS 加入您的 Tailscale 网络。
- 加固服务器,并在 Docker 中启动代理运行时。
- 配置代理网关,只能通过您的 tailnet 访问。
整个过程大约需要 2 到 3 分钟。镜像已预装代理所需的一切,服务器无需从头安装软件包——这正是部署如此之快的原因。完成后,CLI 会打印出接下来要运行的两条命令。
如果 VPS 上已有需要替换的数据,--reinstall 会清空服务器并用 Office Claws 镜像重新安装。只在可以放心清空的服务器上使用它。
第 5 步:连接您的 Codex 订阅
officeclaws connect-codex该命令会在浏览器中打开 OpenAI 的登录页面(或打印链接)。用拥有 Codex 的 ChatGPT 账户登录;CLI 会等待您完成登录(最多五分钟),并在代理开始使用您的订阅运行时给出确认。Codex 是 Office Claws 代理支持的模型接入方式——不支持 Claude Code 及其他 Anthropic 订阅。
第 6 步:开始与代理对话
officeclaws chat该命令打开与主代理的交互式对话(按 Ctrl-D 退出)。用 officeclaws chat -m "..." 发送单条消息,用 --agent <id> 与指定代理对话,用 officeclaws agents 列出所有代理,用 officeclaws logs --follow 实时查看代理日志。
试试以下消息来测试您的设置:
- "你能帮我做什么?"
- "帮我总结这份文档:[粘贴文本]"
- "检查这段代码有没有 bug:[粘贴代码]"
在桌面应用中,同一个代理会出现在像素艺术办公室的工位上——点击它的精灵即可打开聊天面板。面板保留完整的消息记录,方便您从上次中断的地方继续。
了解像素艺术办公室
如果您使用桌面应用,办公室不仅仅是一个视觉装饰。它让您一目了然地掌握所有代理的状态:
- 在工位上打字 — 代理正在处理任务或处于可用状态。
- 去倒咖啡 — 代理处于短暂的空闲周期。
- 在沙发上休息 — 代理处于较长的空闲状态。
- 坐在离线区域 — 代理的 VPS 无法连接。
随着您添加更多代理,每个代理都会被分配到办公室中的一张桌子。布局支持主办公室最多六张桌子、侧办公室一张桌子,以及休息区的沙发座位。
凭据如何保持安全
当一个工具要接触您的云账户和 AI 账户时,安全自然是常见的顾虑。Office Claws 的做法如下:
- 本地钥匙串存储。 您的 Contabo API 凭据、Tailscale 授权密钥和 CLI 会话都保存在操作系统的钥匙串中,而不是 Office Claws 的服务器上。机密值从不打印——凭据列表只显示遮蔽后的预览。
- 您自己的网络。 CLI 和桌面应用通过您的 Tailscale 网络以 SSH 访问代理。代理的 SSH、HTTPS 和网关端口只在您的 tailnet 内开放。
- 您自己的订阅。 连接 Codex 使用的是 OpenAI 的登录流程:您在 OpenAI 的页面上登录,不需要四处复制 API 密钥。登录凭证保存在您代理的 VPS 上。
- 直接连接。 对话和日志通过您的 tailnet 在您的电脑与代理之间直接传输。运行
officeclaws connect-codex之后,模型请求从代理的 VPS 直接发往 OpenAI;在此之前,少量起步额度会经过 Office Claws LLM 网关。Office Claws 会在您的账户中保存一份聊天记录副本;具体存储了哪些内容,请见安全页面。
Office Claws 自动化了什么:您跳过的手动设置
要理解一条命令完成部署的价值,不妨看看没有它时手动搭建一台安全的 AI 代理 VPS 是什么样子。以下是 Office Claws 在后台自动完成的每一个步骤。如果您自己动手,每台服务器需要预留 45 分钟到 1 小时的终端操作时间——前提是每条命令都一次成功。
创建并访问服务器
手动操作时,您需要登录云服务商(Contabo、Hetzner、DigitalOcean 或其他),创建一台 Ubuntu 24.04 服务器,等待它启动,然后以 root 身份 SSH 登录。您还需要生成 SSH 密钥对、上传公钥并确认可以连接。
创建非 Root 用户
以 root 身份运行服务存在安全风险。您需要创建一个专用用户,将其添加到 sudo 组,将 SSH 公钥复制到其 authorized_keys 文件中,并设置正确的文件权限(.ssh 目录为 700,密钥文件为 600)。然后配置针对特定命令(防火墙、Tailscale 和 Docker)的免密码 sudo 访问,这样代理进程可以管理这些服务而无需完整的 root 权限。
加固 SSH
全新 Ubuntu 服务器上的 SSH 默认允许 root 登录和密码认证——这两者都是常见的攻击载体。您需要编写加固配置来禁用以下所有选项:
- Root 登录(
PermitRootLogin no) - 密码认证(
PasswordAuthentication no) - 质询-响应认证
- X11 转发
- 代理转发
然后使用 sshd -t 验证配置语法并重启 SSH 服务。这个文件中的一个拼写错误就可能让您被锁在服务器外面。
安装和配置防火墙
接下来,安装 ufw(简易防火墙)并设置拒绝所有入站连接的默认策略。您需要临时在所有接口上允许 SSH,以免断开连接,然后——在 Tailscale 运行后——将 SSH、HTTPS 和代理网关端口(18789)限制为仅通过 Tailscale 接口访问,并删除公网 SSH 规则。最终的防火墙状态:
- 所有入站流量默认拒绝
- 端口 22(SSH):仅允许通过 Tailscale
- 端口 443(HTTPS):仅允许通过 Tailscale
- 端口 18789(代理网关):仅允许通过 Tailscale
- 所有出站流量允许
如果操作顺序出错——在 Tailscale 启动前限制 SSH——意味着完全失去服务器的访问权限。
设置入侵防护
安装并启用 fail2ban,它会监控认证日志并临时封禁显示暴力登录模式的 IP 地址。即使 SSH 因配置错误而暴露,这也增加了一层防御。
启用自动安全更新
安装 unattended-upgrades 和 apt-listchanges,然后使用 dpkg-reconfigure 进行配置。这确保服务器自动应用安全补丁,无需人工干预。跳过此步骤意味着您的服务器在几周内就会落后于补丁更新。
分配交换内存
在 /swapfile 创建 2 GB 的交换文件,设置权限为 600,使用 mkswap 格式化,使用 swapon 激活,并添加到 /etc/fstab 使其在重启后持久存在。没有交换内存的话,代理进程的内存峰值可能会杀死容器或导致服务器崩溃。
安装和配置 Tailscale
从官方安装脚本安装 Tailscale,使用您的授权密钥和主机名启动,等待 IP 分配(最多 60 秒),将操作者设置为非 root 用户,请求 TLS 证书,并在代理网关端口上启用 HTTPS 服务。这创建了加密隧道,取代了所有代理通信的公网暴露。
安装 Docker 并拉取代理镜像
从官方安装脚本安装 Docker,将非 root 用户添加到 docker 组,如需要则进行容器注册表认证,并预拉取代理运行时镜像。然后使用正确的环境变量、内存限制(1800 MB,2 GB 交换内存)、主机网络、持久卷和重启策略(确保重启后存活)启动容器。
连接模型服务商
配置代理的模型访问方式——以环境变量形式传入容器的 API 密钥,或像 Codex 这样的订阅登录——并为网关配置 WebSocket 连接、TLS 和操作员权限。然后等待网关初始化完成,再从容器日志中提取认证令牌。
验证一切正常
确认防火墙规则正确、Tailscale 已连接、Docker 容器正在运行、代理通过网关响应,以及您的本地机器可以通过 Tailscale 网络访问它。更新本地 SSH 配置和 known_hosts 以便日后方便访问。
这些加起来意味着什么
以下是每个 Office Claws 代理 VPS 上配置的所有软件包和服务的完整列表:
| 组件 | 用途 |
|---|---|
ufw | 仅限 Tailscale 访问规则的防火墙 |
fail2ban | 暴力破解入侵防护 |
unattended-upgrades | 自动安全补丁 |
| SSH 加固配置 | 禁用 root 登录、密码、转发 |
| Tailscale | 加密网络和 TLS 证书 |
| Docker | 带内存限制的容器化代理运行时 |
| 2 GB 交换内存 | 内存溢出保护 |
| 具有限定 sudo 权限的非 root 用户 | 最小权限原则 |
这是跨越大约 20 个手动步骤配置的八层安全防护,每一步都有各自的失败模式。防火墙顺序搞错,您会被锁在外面。忘记交换内存,代理在负载下崩溃。跳过 unattended-upgrades,服务器会积累漏洞。SSH 加固配置出错,您会留下一扇敞开的门——或者把自己关在外面。
使用 Office Claws,您只需运行 officeclaws onboard,看着进度输出两三分钟,就能获得以上全部——加固、测试、连接就绪。基于镜像的部署意味着每台服务器都从预构建、经过验证的镜像启动,您预期的和实际得到的毫无偏差。
常见设置问题排查
"No active subscription"
如果账户没有有效订阅,引导流程会停止。运行 officeclaws subscribe 完成结账,然后重新运行 officeclaws onboard。
Contabo 凭据被拒绝
在 my.contabo.com/api/details 上逐一核对四项值。最常见的错误是输入了网站登录密码而不是 API 密码。如果您从未设置过 API 密码,请先在该页面设置。
"No VPSes found on your account"
引导流程会把您 Contabo 账户中已有的一台 VPS 变成代理。请先在 Contabo 订购 VPS,等它运行起来后再重新运行 officeclaws onboard。
部署时间比预期长
部署通常需要 2 到 3 分钟。如果明显更慢,可能是 Contabo 还在准备服务器——请在 Contabo 控制面板中查看其状态。使用 --reinstall 时耗时更长,因为 Contabo 需要先重装服务器镜像。如果部署失败,CLI 会打印错误信息,officeclaws agents 会显示代理状态,完整日志位于 ~/.openclaw/logs。
Tailscale 授权密钥被拒绝
确认密钥没有过期;如果是一次性密钥,确认它还没有被使用过。在 Tailscale 管理控制台生成新密钥,并通过 officeclaws onboard --tailscale-authkey <密钥> 传入。
代理显示离线或对话无法连接
确认您电脑上的 Tailscale 正在运行。chat 和 logs 通过您的 tailnet 访问代理,因此两端都需要连接。打开 Tailscale 应用,确认您的设备显示为 "Connected"。
接下来做什么
第一个代理运行起来之后:
- 添加更多代理。 每个代理都有自己的 VPS 和办公室里的工位。在 Contabo 再订购一台 VPS,然后再次运行
officeclaws onboard。 - 安排定期任务。
officeclaws cron add用于创建定时任务,officeclaws telegram set让您可以通过 Telegram 与代理对话。 - 探索代理人设。 不同的
--comm-style设置会带来明显不同的互动方式。
设置 Office Claws 只需几分钟,换来的是一个持久运行的 AI 工作空间——无论终端或应用是否打开,它都在持续运行。您的代理在各自的 VPS 上继续工作,需要时随时重新连接即可。