agent

环境要求

• 支持 Linux、macOS 或 Windows 系统
• 可选使用 Docker 运行（镜像已内置常用 DevOps CLI）
• 需要一个 Stakpak API Key，或自备 Anthropic / OpenAI API Key（BYOK）
• 运行容器化运维任务时需挂载 Docker socket /var/run/docker.sock

安装与启动步骤

1. 1安装 Stakpak CLI

   用官方安装脚本一键安装 Stakpak 命令行工具，安装后终端会出现 stakpak 命令。其他安装方式见官方文档。

   curl -sSL https://stakpak.dev/install.sh | sh

   复制

2. 2初始化识别技术栈

   运行 init 让 agent 了解你机器上的应用和技术栈，为后续自动运维做铺垫。

   stakpak init

   复制

3. 3首次认证获取 Key

   直接运行 stakpak 并按提示操作，会自动为你创建 API Key，无需信用卡。

   stakpak

   复制

4. 4非交互式登录(CI)

   在脚本或 CI 环境中，用已有 Key 直接登录，避免交互式流程。

   stakpak auth login --api-key $STAKPAK_API_KEY

   复制

5. 5启动 Autopilot

   启动 7x24 驻留后台的自主 agent，也可用简写别名 stakpak up。

   stakpak autopilot up

   复制

6. 6查看状态与日志

   用 status 确认 agent 是否在运行，用 logs 排查执行情况，doctor 做健康检查。

   stakpak autopilot status
   stakpak autopilot logs
   stakpak autopilot doctor

   复制

7. 7用 Docker 跑 TUI

   拉取官方镜像后，可直接以交互方式启动 agent TUI；做容器化任务时需挂载 Docker socket 和应用目录。

   docker pull ghcr.io/stakpak/agent:latest
   docker run -it --entrypoint stakpak ghcr.io/stakpak/agent:latest

   复制

8. 8停止 Autopilot

   需要停机时用 down 子命令或其别名 stakpak down 关闭后台运行时。

   stakpak autopilot down

   复制

关键配置

如何确认成功

执行 stakpak autopilot status 看到运行状态正常，再用 stakpak autopilot logs 确认有任务日志输出。

常见问题

注意事项

• Docker 镜像内置 docker、kubectl、aws cli、gcloud、azure cli 等常用工具，适合日常 DevOps 任务。
• 用容器执行容器化任务时，必须挂载 /var/run/docker.sock 并挂载应用目录到 /agent/。
• schedule 与 channel 的 profile 是分开的：分别控制定时任务和来自 Slack/Telegram/Discord 会话的行为。
• 安装脚本支持 Linux、macOS、Windows，更多安装方式见官方文档 stakpak.gitbook.io/docs。