名称： coder-workspaces
描述： 通过 CLI 管理 Coder 工作空间与 AI 编程代理任务。可列出、创建、启动、停止和删除工作空间，通过 SSH 进入工作空间执行命令，并创建和监控使用 Claude Code、Aider 等代理的 AI 编程任务。
元数据：
openclaw:
emoji: "🏗️"
requires:
bins: ["coder"]
env: ["CODER_URL", "CODER_SESSION_TOKEN"]

Coder 工作空间

通过 coder CLI 管理 Coder 工作空间及 AI 编程代理任务。

注意：所有命令均在独立、受管控的 Coder 工作空间内执行，而非宿主机系统。

环境配置

使用 coder CLI 前，请先配置身份验证：

1. 从 Coder CLI 文档 安装 CLI
2. 设置环境变量：
   bash export CODER_URL=https://your-coder-instance.com export CODER_SESSION_TOKEN=<your-token> # 从 /cli-auth 获取
3. 测试连接：
   bash coder whoami

工作空间命令

coder list                              # 列出工作空间
coder list --all                        # 包含已停止的工作空间
coder list -o json                      # 以 JSON 格式输出

coder start <workspace>                 # 启动工作空间
coder stop <workspace>                  # 停止工作空间
coder restart <workspace> -y            # 重启工作空间（自动确认）
coder delete <workspace> -y             # 删除工作空间（自动确认）

coder ssh <workspace>                   # 进入交互式 Shell
coder ssh <workspace> -- <command>      # 在工作空间内执行命令

coder logs <workspace>                  # 查看日志
coder logs <workspace> -f               # 实时跟踪日志

AI 编程任务

Coder Tasks 可在独立工作空间中运行 AI 代理（如 Claude Code、Aider 等）。

创建任务

coder tasks create --template <模板> --preset "<预设>" "任务提示"

• 模板：必需。可通过 coder templates list 查看可用模板
• 预设：可能必需。建议先尝试不指定预设。若创建失败并提示“Required parameter not provided”，请使用 coder templates presets list <模板> -o json 获取预设列表，并选用默认预设。若无默认预设，需询问用户选择。

管理任务

coder tasks list                        # 列出所有任务
coder tasks logs <任务名称>             # 查看任务输出日志
coder tasks connect <任务名称>          # 进入交互式会话
coder tasks delete <任务名称> -y        # 删除任务（自动确认）

任务状态说明

• Initializing：工作空间正在初始化（时长因模板而异）
• Working：运行设置脚本
• Active：代理正在处理任务提示
• Idle：代理等待输入

故障排除

• CLI 未找到：请查阅 Coder CLI 文档
• 身份验证失败：确认 CODER_URL 和 CODER_SESSION_TOKEN 已正确设置，然后运行 coder login
• 版本不匹配：请从您的 Coder 实例重新安装 CLI

更多信息

• Coder 文档
• Coder CLI
• Coder Tasks