imclaw

agent
Guvenlik Denetimi
Basarisiz
Health Uyari
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 5 GitHub stars
Code Basarisiz
  • rm -rf — Recursive force deletion command in scripts/install.sh
Permissions Gecti
  • Permissions — No dangerous permissions requested

Bu listing icin henuz AI raporu yok.

SUMMARY

acp skill for openclaw, claude cc, codex, gemini cli, pi and others

README.md

IMClaw

IMClaw 是一个支持 ACP 协议的 AI Agent 网关,通过 CLI 与 Agent 交互。

功能特性

  • ACP 协议: 通过 acpx 支持 Claude、Codex 等 AI Agent
  • 多会话管理: 支持 /new 新建会话
  • 多 Agent 支持: 动态创建 Agent,通过命令切换
  • 权限控制: 支持多种权限模式
  • 统一网关: HTTP 和 WebSocket 使用同一端口

安装

方式一:下载预编译二进制

Releases 页面下载对应平台的二进制文件。

方式二:使用 Go 安装

go install github.com/smallnest/imclaw/cmd/imclaw@latest
go install github.com/smallnest/imclaw/cmd/imclaw-cli@latest

方式三:从源码构建

# 克隆仓库
git clone https://github.com/smallnest/imclaw.git
cd imclaw

# 构建
make build

# 或者直接使用 go build
go build -o bin/imclaw ./cmd/imclaw
go build -o bin/imclaw-cli ./cmd/imclaw-cli

快速开始

运行服务器

# 使用默认参数
./bin/imclaw

# 指定端口和认证令牌
./bin/imclaw --port 9000 --token my-secret-token

# 查看帮助
./bin/imclaw --help

服务器参数

参数 简写 默认值 说明
--host -H 0.0.0.0 服务监听地址
--port -p 8080 服务端口
--timeout 30 默认超时时间(秒)
--token "" 认证令牌(为空则不校验认证)
--version 显示版本信息

CLI 工具

IMClaw 提供了命令行工具 imclaw-cli,可以直接与 Agent 交互。

构建 CLI

make build-cli
# 或
go build -o bin/imclaw-cli ./cmd/imclaw-cli

安装 CLI

make install-cli
# 安装后可以直接使用 imclaw-cli 命令

使用方式

交互模式(REPL)

# 直接运行进入交互模式
./bin/imclaw-cli

# 指定 Agent
./bin/imclaw-cli --agent codex

# 使用指定的 Session ID
./bin/imclaw-cli --session my-session-123

# 指定权限模式和输出格式
./bin/imclaw-cli --approve-all --format json

单条消息

# 使用 -p/--prompt 参数(推荐)
./bin/imclaw-cli -p "什么是 Go 语言?"
./bin/imclaw-cli --prompt "什么是 Go 语言?"

# 或直接传递消息
./bin/imclaw-cli "什么是 Go 语言?"

# 指定 Agent
./bin/imclaw-cli --agent codex -p "Hello"

# 使用指定 Session(可复用会话)
./bin/imclaw-cli --session my-session -p "继续之前的对话"

# JSON 输出格式
./bin/imclaw-cli --format json -p "Hello"

# 自动批准所有权限请求
./bin/imclaw-cli --approve-all -p "Hello"

# 只读模式(拒绝所有写操作)
./bin/imclaw-cli --deny-all -p "分析这段代码"

CLI 参数

参数 说明
--server <url> IMClaw 服务器 WebSocket URL(默认:ws://localhost:8080/ws)
--token <token> 认证令牌
-p, --prompt <message> 提示消息(单次执行模式)
--session <id> 指定使用的 Session ID(为空则自动创建)
--agent <type> Agent 类型(claude, codex 等)
--cwd <dir> 工作目录
--auth-policy <policy> 认证策略:skip 或 fail
--approve-all 自动批准所有权限请求
--approve-reads 自动批准读取请求,写入需要确认(默认)
--deny-all 拒绝所有权限请求(只读模式)
--non-interactive-permissions <policy> 非交互模式下的权限策略:deny 或 fail
--format <fmt> 输出格式:text, json, quiet(默认:text)
--suppress-reads 禁止输出原始读取文件内容
--model <id> Agent 模型 ID
--allowed-tools <list> 允许的工具名称(逗号分隔)。默认:Bash,Read,Write。空字符串=允许所有
--max-turns <count> 会话最大轮次
--prompt-retries <count> 失败重试次数
--json-strict 严格 JSON 模式(需要 --format json)
--timeout <seconds> 等待 Agent 响应的最大时间
--ttl <seconds> 队列所有者空闲 TTL
--verbose 启用详细调试日志

REPL 命令

在交互模式下,支持以下命令:

命令 说明
/new 创建新会话(清除上下文)
/session 显示当前会话信息
/agent <name> 切换到指定的 Agent
/agents 列出可用的 Agent
/help 显示帮助
/quit 退出 CLI

依赖

  • Go 1.25.0+
  • acpx (用于 ACP 协议支持)

安装 acpx

npm install -g acpx@latest

License

MIT License

Yorumlar (0)

Sonuc bulunamadi