PicoClawを最初に動かすまでのメモ

Posted: 2026-03-15   |   Tags: ai, getting-started, picoclaw, slack

PicoClawを最初に動かすまでのメモ

PicoClaw は設定項目が多いが、最初は全部を理解しなくても動かせる。

この記事では、次の流れだけに絞る。

1. PicoClaw を用意する
2. ~/.picoclaw/config.json を作る
3. モデルを 1 つ設定する
4. 必要なら Slack を 1 つつなぐ
5. picoclaw gateway を起動する
6. DM またはメンションで疎通確認する

1. PicoClaw を用意する

ソースから使うなら、まずリポジトリを取得してビルドする。

git clone https://github.com/sipeed/picoclaw.git
cd picoclaw
make deps
make build

インストール済みの picoclaw バイナリを使うなら、この段階は省略できる。

2. 初期ファイルを作る

最初に設定ファイルと workspace を作る。

picoclaw onboard

これで通常は次が作られる。

• ~/.picoclaw/config.json
• ~/.picoclaw/workspace/

workspace 配下には、AGENT.md や USER.md、skills/ などのベースファイルが入る。

3. 最小の config.json を書く

最初は API で使うモデルを 1 つだけ定義すれば十分だ。

{
  "agents": {
    "defaults": {
      "workspace": "~/.picoclaw/workspace",
      "restrict_to_workspace": true,
      "model_name": "gpt-5.4"
    }
  },
  "model_list": [
    {
      "model_name": "gpt-5.4",
      "model": "openai/gpt-5.4",
      "api_key": "sk-your-openai-key",
      "api_base": "https://api.openai.com/v1"
    }
  ]
}

ここで大事なのは次の3つ。