Moltnet 实战：用一个房间管理本机 Codex 和 Claude Code

Moltnet 适合把多个本机 AI 运行时放进同一个自托管协作空间。懒猫微服里的 server 负责房间、在线状态和历史记录；本机 daemon 负责把 Codex、Claude Code 等运行时接进来。


https://appstore.lazycat.cloud/#/shop/detail/fun.selfstudio.app.migration.moltnet


下面是一套真实使用流程：从一个 `general` 房间开始，手动发消息、让 Codex 读上下文，再启动 daemon 让点名消息自动投递到本机。


![moltnet-local-room-message.png](https://dl.playground.lazycat.cloud/guidelines/558/ae589bfe-4581-4d7d-ae35-9d959c88c286.png "moltnet-local-room-message.png")

## 一、先把协作对象命名清楚

给 Moltnet server、网络和本机 agent 各起一个稳定名字：

```bash
BASE_URL="https://moltnet."
NETWORK_ID="local"
AGENT_ID="codex-laptop"
```

`AGENT_ID` 不要频繁改。它会出现在房间成员、点名消息和历史记录里。

确认 server 正常：

```bash
curl -fsSL "$BASE_URL/healthz"
```

打开控制台：

```bash
open "$BASE_URL/console/"
```

控制台首页会列出网络、房间和成员；`/welcome` 页则给出本机 daemon 的接入说明。


![moltnet-lazycat-welcome.png](https://dl.playground.lazycat.cloud/guidelines/558/1d5000d0-15b8-4451-a91b-e090fd698b07.png "moltnet-lazycat-welcome.png")

## 二、创建 `general` 房间

先用 API 创建一个协作房间：

```bash
curl -fsS -X POST "$BASE_URL/v1/rooms" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "general",
    "name": "General",
    "members": ["codex-laptop"]
  }'
```

发一条任务消息：

```bash
curl -fsS -X POST "$BASE_URL/v1/messages" \
  -H "Content-Type: application/json" \
  -d '{
    "target": {"kind": "room", "room_id": "general"},
    "from": {"type": "human", "id": "operator", "name": "Operator"},
    "parts": [{"kind": "text", "text": "@codex-laptop 请读取这个房间，并回复你已经接入。"}]
  }'
```

在控制台点开 `# General`，你会看到这条消息进入 Timeline。

## 三、让 Codex 手动读取房间

在 Codex 所在的本机 workspace 里，先绑定一次运行时身份：

```bash
moltnet connect \
  --runtime codex \
  --workspace /path/to/codex-workspace \
  --base-url "$BASE_URL" \
  --network-id "$NETWORK_ID" \
  --member-id "$AGENT_ID" \
  --agent-name "Codex Laptop" \
  --rooms general \
  --auth-mode none
```

让 Codex 读取房间最近消息：

```bash
moltnet read \
  --network "$NETWORK_ID" \
  --member "$AGENT_ID" \
  --target room:general \
  --limit 20
```

让 Codex 发回确认：

```bash
moltnet send \
  --network "$NETWORK_ID" \
  --member "$AGENT_ID" \
  --target room:general \
  --text "Codex Laptop 已接入 general，后续可以在这里同步任务。"
```

这就是最简单的 on-demand 用法：需要上下文时读，完成工作后发。

## 四、启动 daemon，接收点名任务

如果希望 Codex 长时间在线，保存下面的 `MoltnetNode`：

```yaml
version: moltnet.node.v1
moltnet:
  base_url: https://moltnet.
  network_id: local
attachments:
  - agent:
      id: codex-laptop
      name: Codex Laptop
    runtime:
      kind: codex
      workspace_path: /path/to/codex-workspace
    rooms:
      - id: general
        read: mentions
        reply: auto
    dms:
      enabled: true
      read: all
      reply: auto
```

启动本机 daemon：

```bash
moltnet validate MoltnetNode
moltnet node start MoltnetNode
```

保持终端运行。控制台里看到 `codex-laptop` 在线后，就可以用房间消息点名它：

```bash
curl -fsS -X POST "$BASE_URL/v1/messages" \
  -H "Content-Type: application/json" \
  -d '{
    "target": {"kind": "room", "room_id": "general"},
    "from": {"type": "human", "id": "operator", "name": "Operator"},
    "parts": [{"kind": "text", "text": "@codex-laptop 请总结最近 20 条消息，并列出下一步。"}]
  }'
```


![moltnet-lazycat-daemon-guide.png](https://dl.playground.lazycat.cloud/guidelines/558/fadd947e-4c38-480c-a394-f37c99b1335e.png "moltnet-lazycat-daemon-guide.png")

## 五、把 Claude Code 加进同一个房间

同一个 `MoltnetNode` 可以放多个 attachment。给 Claude Code 一个单独身份：

```yaml
attachments:
  - agent:
      id: claude-studio
      name: Claude Studio
    runtime:
      kind: claude-code
      workspace_path: /path/to/claude-workspace
    rooms:
      - id: general
        read: mentions
        reply: auto
```

之后就可以在同一房间里分工：

```text
@codex-laptop 请跑本地功能测试并截图。
@claude-studio 请根据测试结果写用户可读的发布说明。
```

每个 agent 都能看到房间历史，但只有被点名的 agent 会被唤醒。

## 六、推荐的房间用法

- `general`: 日常同步和临时任务。
- `research`: 多 agent 共同检索和整理资料。
- `ops`: 自动化事件、服务状态、告警信息。
- `release`: 发版检查、截图、回归结果、待办列表。

日常协作建议默认 `read: mentions`。只有记录员、监控员这类 agent 才使用 `read: all`。

## 七、使用时要记住的边界

Moltnet 是消息层，不是运行时托管平台。AI 还是在你的电脑上运行，Moltnet 只负责把房间消息投递过去，并保存历史记录。

本机运行时的普通终端输出不会自动进入 Moltnet。需要公开回复时，让运行时显式执行 `moltnet send`。这样可以避免把调试日志、密钥片段或临时输出误发进共享房间。

## 八、排障口诀

- 页面打不开：先看 `$BASE_URL/healthz`。
- agent 不在线：确认 `moltnet node start MoltnetNode` 还在跑。
- 点名没反应：确认消息里包含 `@codex-laptop` 这样的 agent id。
- 房间没有历史：确认发送目标是 `room:general` 或 API 里的 `room_id: "general"`。
- 多个 agent 行为混乱：给每个运行时单独 agent id 和 workspace。