# 电脑智能体（Gateway）

> 用 dino gateway 把电脑上的 Claude Code、Codex、Cursor 等 AI 助手挂到 Dinox App 里，在手机上给它们派活，它们在你的电脑上运行。

- 网页：https://dinox.info/guides/cli/gateway
- 本页 Markdown：https://dinox.info/guides/cli/gateway.md
- 全部文档索引：https://dinox.info/llms.txt

你的电脑上装着 Claude Code、Codex、Cursor Agent……它们能读写你电脑上的项目文件、跑命令，比云端 AI 能做的多得多。`dino gateway` 把它们挂到 Dinox App 里，变成「电脑智能体」：你在手机上发一句话，对话就发到那台电脑上，由那里的 AI 助手执行，结果再回到 App。

![截图：Gateway 工作方式示意（App 里的对话 → 云端转发 → 你电脑上的 dino 后台服务 → 本机 AI 助手（ACP 协议）执行并回复）](https://dinox.info/assets/docs/cli/diagram-gateway.webp)

## 案例：把本机的 AI 助手全部挂上去

### 第 1 步：看看电脑上有哪些能用

```bash
dino gateway detect
```

`detect` 会在系统 `PATH` 里找支持 ACP（Agent Client Protocol）的 AI 助手，并真的和每一个握一次手，确认能启动：

![截图：dino gateway detect 输出（Claude Code、Codex、Cursor、DeepSeek Harness、Qoder、OpenCode 都 ready；有一个没有响应）](https://dinox.info/assets/docs/cli/gateway-detect.webp)

它只认本机已经装好的命令，不会为了探测去下载任何东西。Claude Code 和 Codex 需要各自的 ACP 适配器；运行 `dino update` 时，`dino` 会为已安装的 Claude Code、Codex 等自动补装适配器。

### 第 2 步：一键添加

```bash
dino gateway detect --add
```

把所有 ready 的助手写进你账号的 Gateway 配置，并交给后台服务托管。也可以只加一个，或者加一个 `detect` 找不到的：

```bash
dino gateway add Hermes --command hermes --arg acp --cwd ~/projects
```

`--cwd` 指定默认工作目录，`--env KEY=VALUE` 给它传环境变量（只保存在本机）。

### 第 3 步：确认已经挂上

```bash
dino gateway list
```

![截图：dino gateway list 输出（已配置的电脑智能体：显示名、协议和启动命令（环境变量只显示名字，不显示值））](https://dinox.info/assets/docs/cli/gateway-list.webp)

```bash
dino gateway status
```

![截图：dino gateway status 输出（每个电脑智能体都是 connected，App 里能看到它们在线）](https://dinox.info/assets/docs/cli/gateway-status.webp)

### 第 4 步：在 App 里使用

打开 Dinox App，在智能体的设置里找到 **运行在**，选择一个电脑智能体。之后这个智能体的对话都会发到那台电脑上运行，并显示「在线 / 离线」状态。每个会话会记住开始时的工作目录，App 里还能浏览这个目录下的文件。

电脑智能体执行任务时，可以通过 `dino` 读写你的 Dinox 笔记、待办、标签、文件夹，还能把电脑上生成的文件直接发回对话。

> **注意**
> 电脑智能体运行在你的电脑上，拥有和你一样的文件和命令权限。只给自己信任的智能体选择电脑运行；电脑关机、睡眠或后台服务停止时，它会显示离线，消息要等它上线后才能发送。

## 管理

| 命令                         | 作用             |
| -------------------------- | -------------- |
| `dino gateway list`        | 列出已配置的电脑智能体    |
| `dino gateway status`      | 实时连接状态         |
| `dino gateway reload`      | 修改配置后让后台服务重新读取 |
| `dino gateway remove <名字>` | 移除并停止托管        |

> **提示**
> Gateway 依赖后台服务。`gateway add` 时如果还没装后台服务，`dino` 会自动安装；用 `dino daemon status` 确认它在运行，见 [同步与后台服务](https://dinox.info/guides/cli/sync-and-daemon.md)。