You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
**执行方式**: 通过 `acpx` CLI 调用 Claude Code,而非原生 subagent 或 PTY
928
+
929
+
#### 会话命名规则
930
+
```
931
+
acpx-claude-{openclaw_session_id}
932
+
```
933
+
934
+
#### 超时设置
935
+
- 默认超时: 600秒 (10分钟)
936
+
- 复杂任务: 1200秒 (20分钟) 或更长
937
+
938
+
#### 输出过滤(只显示给用户的内容)
939
+
需要过滤的元信息前缀:
940
+
941
+
| 前缀 | 含义 | 处理方式 |
942
+
|------|------|----------|
943
+
| `[client] initialize` | 客户端初始化 | 隐藏 |
944
+
| `[tool] ...` | 工具调用日志 | 隐藏 |
945
+
| `[thinking] ...` | 思考过程 | 隐藏 |
946
+
| `[done] end_turn` | 回复完成 | 隐藏 |
947
+
948
+
#### 错误处理模板
949
+
```bash
950
+
${ACPX_CMD} claude exec "任务描述" || echo "❌ 任务执行失败"
951
+
```
952
+
953
+
#### 会话管理(推荐:优先使用持久会话)
954
+
955
+
**首次创建会话**(每个项目/任务只做一次):
956
+
```bash
957
+
acpx claude sessions new --name acpx-claude-{session_id}
958
+
```
959
+
960
+
**后续使用持久会话**(保留上下文):
961
+
```bash
962
+
acpx claude -s acpx-claude-{session_id} "任务描述"
963
+
```
964
+
965
+
**查看会话状态**:
966
+
```bash
967
+
acpx claude sessions show acpx-claude-{session_id}
968
+
```
969
+
970
+
**关闭会话**:
971
+
```bash
972
+
acpx claude sessions close acpx-claude-{session_id}
973
+
```
974
+
975
+
#### 一次性执行(仅用于简单、无需上下文的任务)
976
+
```bash
977
+
acpx claude exec "任务描述"
978
+
```
979
+
980
+
#### 工作目录处理(--cwd)
981
+
982
+
acpx 支持 `--cwd` 参数指定工作目录。
983
+
984
+
**⚠️ 重要规则**:如果用户在自然语言任务描述中**明确提及了工作区路径**,必须:
985
+
1. 将该路径通过 `--cwd` 参数原样传入
986
+
2. **严格使用用户提及的原路径**,禁止传入自以为"正确"的路径
987
+
3. 路径优先级:用户明确指定的路径 > 当前 OpenClaw 工作区
988
+
989
+
**示例**:
990
+
```bash
991
+
# 用户说:"在 /home/user/projects/myapp 目录下修复 bug"
992
+
# ✅ 正确做法:
993
+
acpx claude -s acpx-claude-{session_id} --cwd /home/user/projects/myapp "修复 bug"
994
+
995
+
# ❌ 错误做法(禁止这样做):
996
+
# acpx claude -s acpx-claude-{session_id} --cwd /home/user/.openclaw/workspace "修复 bug"
997
+
```
998
+
999
+
#### 二进制路径
1000
+
```bash
1001
+
ACPX_CMD="acpx" # 已全局安装
1002
+
```
1003
+
1004
+
---
1005
+
921
1006
## 💓 Heartbeats - Be Proactive!
922
1007
923
1008
When you receive a heartbeat poll (message matches the configured heartbeat prompt), don't just reply `HEARTBEAT_OK` every time. Use heartbeats productively!
0 commit comments